Checkout Sessions - Cobrix Docs

Crear Sesión de Checkout

Crea una nueva sesión de checkout para que el usuario complete el pago.

companyId

string

required

ID de tu empresa en Cobrix

companyCustomerId

string

required

ID del cliente (obtenido de /resolve-customer)

productId

string

required

ID del producto (obtenido de /checkout/product)

quantity

integer

default:"1"

Cantidad de productos

successUrl

string

URL de redirección tras pago exitoso

cancelUrl

string

URL de redirección si el usuario cancela

expiresInMinutes

integer

default:"60"

Tiempo de expiración de la sesión

metadata

object

Datos adicionales (se incluyen en webhooks)

curl -X POST "https://sandbox-api.cobrix.co/api/checkout/session" \
  -H "Authorization: Bearer tu_access_token" \
  -H "Content-Type: application/json" \
  -d '{
    "companyId": "22991695-c790-4ed2-882b-c60e6190d442",
    "companyCustomerId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "productId": "550e8400-e29b-41d4-a716-446655440000",
    "quantity": 1,
    "successUrl": "https://tu-ecommerce.com/pago-exitoso",
    "cancelUrl": "https://tu-ecommerce.com/pago-cancelado",
    "metadata": {
      "orderId": "ORD-12345",
      "source": "web"
    }
  }'

{
  "sessionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "checkoutUrl": "https://sandbox.cobrix.co/checkout/{token}",
  "expiresAt": "2026-01-22T11:00:00.000Z",
  "status": "active",
  "amountMinor": 5000,
  "currency": "USD",
  "allowedMethods": ["pagoMovil", "zelle", "debitoInmediato", "transferencia"]
}

Obtener Estado de Sesión

sessionId

string

required

ID de la sesión de checkout

curl -X GET "https://sandbox-api.cobrix.co/api/checkout/session/{sessionId}" \
  -H "Authorization: Bearer tu_access_token"

{
  "sessionId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "active",
  "expiresAt": "2026-01-22T11:00:00.000Z",
  "amountMinor": 5000,
  "currency": "USD"
}

Objeto Sesión

Campo	Tipo	Descripción
`sessionId`	string	UUID de la sesión
`token`	string	Token JWT (para uso interno)
`checkoutUrl`	string	URL para redirigir al usuario
`expiresAt`	string	Fecha de expiración (ISO 8601)
`status`	string	`active`, `completed`, `expired`, `cancelled`
`amountMinor`	integer	Monto en centavos
`currency`	string	Código de moneda
`allowedMethods`	array	Métodos de pago disponibles

Estados de Sesión

Estado	Descripción
`active`	Sesión activa, esperando pago
`completed`	Pago completado exitosamente
`expired`	Sesión expiró sin completar
`cancelled`	Usuario canceló el checkout

Métodos de Pago

Código	Descripción	País
`debitoInmediato`	Débito bancario con OTP	🇻🇪 VE
`pagoMovil`	Pago Móvil P2P	🇻🇪 VE
`c2p`	Pago persona a persona	🇻🇪 VE
`transferencia`	Transferencia bancaria	🇻🇪 VE
`zelle`	Transferencia Zelle	🇺🇸 USA
`binance`	Binance Pay	🌍 Global
`sinpe`	SINPE	🇨🇷 CR

API Reference

​Crear Sesión de Checkout

​Obtener Estado de Sesión

​Objeto Sesión

​Estados de Sesión

​Métodos de Pago

Crear Sesión de Checkout

Obtener Estado de Sesión

Objeto Sesión

Estados de Sesión

Métodos de Pago