Crear una sesión de checkout BNPL (Hosted Checkout)

​

Permite crear una sesión de checkout BNPL (Hosted Checkout).

Headers

  • x-org-id
    Type: string
    required

    UUID de la organización

  • x-api-key
    Type: string

    API Key de la organización (zk_...)

  • x-api-secret
    Type: string

    API Secret de la organización (sk_...)

Body·

required
application/json
  • amount
    Type: number
    required
  • cancelUrl
    Type: string
    required
  • currency
    Type: string
    required
  • customer
    Type:
    required
    Properties: 4
  • items
    Type:
    required
    Properties: 4
  • orderReference
    Type: string
    required
  • successUrl
    Type: string
    required
  • webhookUrl
    Type: string

Responses

  • 201

    Recurso creado correctamente.

  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/api/bnpl/checkout-sessions
curl /api/bnpl/checkout-sessions \
  --request POST \
  --header 'x-org-id: ' \
  --header 'Content-Type: application/json' \
  --header 'x-org-id: YOUR_SECRET_TOKEN' \
  --data '{
  "orderReference": "ORD-10025",
  "amount": 92.8,
  "currency": "USD",
  "customer": {
    "name": "Juan Pérez",
    "documentNumber": "1234567890",
    "phone": "0999999999",
    "email": "cliente@email.com"
  },
  "items": [
    {
      "sku": "PROD-001",
      "name": "Producto de prueba",
      "quantity": 1,
      "unitPrice": 92.8
    }
  ],
  "successUrl": "myapp://bnpl/success",
  "cancelUrl": "myapp://bnpl/cancel",
  "webhookUrl": "https://cliente.com/webhooks/bnpl"
}'
No Body

Recurso creado correctamente.