Create a new order

Partners Integration - Production

https://partners.kapitale.com.br/v1

POST

/order

Creates a new payment order. Scope: orders.create

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Order created successfully

Body

🟠409

🟠400BadRequest

🟠401Unauthorized

🔴500InternalServerError

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://partners.kapitale.com.br/v1/order' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "order_number": "ORD-001",
    "expiry_date": "2025-12-31",
    "requested_amount": 10000,
    "retail_cnpj": "00.000.000/0001-00",
    "retail_representative": "John Smith",
    "retail_email": "joao@empresa.com",
    "retail_phone": "11999999999",
    "purchase_date": "2025-02-26",
    "purchase_items": [
        {
            "value": 5000,
            "quantity": 2,
            "description": "Product A"
        }
    ]
}'

Response Example

201 - Sucesso

{
    "id": "550e8400-e29b-41d4-a716-446655440000",
    "order_no": "ORD-2024-001",
    "expiry_date": "2024-12-31T00:00:00.000Z",
    "requested_amount": 10000.5,
    "paid_amount": 9785.49,
    "retail_fee": 0,
    "industry_fee": 0.0215,
    "payment_status": "pending",
    "order_status": "pending",
    "retail_id": "retail-uuid",
    "industry_id": "industry-uuid",
    "created_at": "2024-01-15T10:30:00.000Z",
    "updated_at": "2024-01-15T10:30:00.000Z"
}

Modified at 2026-03-19 13:59:13

Fetch retail information by CNPJ

List orders