Confirmar una sesión de checkout

post/v1/checkout/sessions/{id}/confirm

La llama el drop-in @cauril/checkout-js desde el browser con el client_secret (no tu server): envía el token del método generado por el PSP y dispara el cobro. Normalmente no la invocás directamente.

Request

BASH

curl -X POST https://api.cauril.com/v1/checkout/sessions/<id>/confirm \
  -H "Authorization: Bearer sk_test_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "provider_token": "string",
    "method": "card",
    "customer_email": "string",
    "installments": 0,
    "payer_name": "string",
    "payer_document": "string",
    "payment_method_id": "string",
    "country": "BR"
  }'

Parámetros

idpathreq

string

Cuerpo ConfirmCheckout

provider_token	string	Token del método generado por el PSP del lado del cliente.
method	string
customer_email	string · email
installments	integer
payer_name	string
payer_document	string	Documento del pagador (ej. CPF) cuando el método/país lo requiere.
payment_method_id	string
country	string

Respuestas

200	Sesión confirmada (vista pública)	CheckoutSessionPublic
402	Error	Error
409	Error	Error
422	Error	Error

Ejemplo de respuesta · 200

JSON

{
  "object": "checkout.session",
  "id": "cs_01J...",
  "status": "open",
  "amount": 5000,
  "currency": "USD",
  "ui": {
    "provider": "stripe",
    "publishable_key": null,
    "methods": [
      "card"
    ]
  },
  "allowed_methods": null,
  "locale": null,
  "success_url": "string",
  "cancel_url": "string",
  "return_url": null,
  "payment": null,
  "expires_at": "2026-06-01T12:00:00Z"
}