3DS Checkout - Kushki Developer Portal

Integrar Checkout es la forma más rápida de aceptar pagos con tarjeta en línea. Obtén la URL de un formulario de pago alojado en la infraestructura de Billpocket, compártela con tus clientes y recibe el resultado por webhook. El formulario gestiona automáticamente los desafíos de 3D Secure: nunca manipulas datos sensibles de la tarjeta.

INFO

Servicio disponible solo en México.

Requisitos

Una cuenta válida

Una API key

Entornos

Entorno	URL base
Dev	`https://test.paywith.billpocket.com`
Live	`https://paywith.billpocket.com`

Configura las URLs de webhook y de redirección

Antes de salir a producción, configura dos URLs en el dashboard, en Configuración > Integraciones, sección E-COMMERCE 3DSECURE:

Campo	Para qué sirve
Url de Webhook	Recibe el resultado de la transacción como webhook
Url de redirección	Redirige al cliente cuando termina el pago

INFO

Las dos URLs deben usar HTTPS e incluir el protocolo (por ejemplo, https://mysite.com/result).

Crear un checkout

POST /api/v1/checkout

Envía tu API key, un identificador externo, los artículos y el monto total.

Solicitud:

{
  "apiKey": "123ABC0-123ABC0-123ABC0-123ABC0",
  "externalId": "ORD-001",
  "items": [
    "Product 1",
    "Product 2",
    "Product 3"
  ],
  "total": 1000,
  "rates": [3, 6]
}

Campo	Tipo	Requerido	Descripción
`apiKey`	string	✅	Tu API key
`externalId`	string	✅	Tu identificador para este checkout
`items`	array	✅	Lista de nombres de los artículos
`total`	number	✅	Monto en MXN
`rates`	array	—	Opciones de diferido a MSI disponibles (por ejemplo, `[3, 6, 12]`)

Respuesta:

{
  "checkoutId": "e8bfb912-c51a-4c62-bb22-876f1f9cc6d1",
  "externalId": "ORD-001",
  "total": "1000.00",
  "items": ["Product 1", "Product 2", "Product 3"],
  "rates": [3, 6],
  "description": "Example",
  "createdAt": "2024-06-12T03:07:25.049Z",
  "updatedAt": "2024-06-12T03:07:25.049Z"
}

Crear la URL del formulario de pago

Concatena el checkoutId de la respuesta a la URL base:

Entorno	URL del formulario de pago
Dev	`https://test.paywith.billpocket.com/checkout/{checkoutId}`
Live	`https://paywith.billpocket.com/checkout/{checkoutId}`

Comparte esta URL con tu cliente para abrir el formulario de pago 3DS alojado. Usa tarjetas de prueba para probar en el entorno Dev.

Consultar los detalles de un checkout

GET /api/v1/checkout/detail/{checkoutId}?apiKey={apiKey}

Consulta el estado y los detalles de un checkout creado previamente.

Respuesta:

{
  "checkout": {
    "items": ["Product 1", "Product 2"],
    "rates": [3, 6],
    "externalId": "ORD-001",
    "total": "1000.00",
    "createdAt": "2024-06-12T01:33:36.593Z",
    "updatedAt": "2024-06-12T01:34:33.001Z"
  },
  "transaction": {
    "status": 1,
    "message": "APROBADA",
    "opId": "128840",
    "txnISOCode": "00",
    "authNumber": "BP9274",
    "ticketUrl": "305214b8c6c5a689118454a69b2214927d5ddc52",
    "maskedPAN": "401200******0071"
  }
}

Siguientes pasos

Configura un webhook para recibir los resultados de las transacciones

Revisa la referencia de la API de Checkout

Usa tarjetas de prueba para simular escenarios 3DS

¿Tienes una sugerencia sobre esta documentación? Contáctanos.

Checkout 3DS

Requisitos#

Entornos#

Configura las URLs de webhook y de redirección#

Crear un checkout#

Crear la URL del formulario de pago#

Consultar los detalles de un checkout#

Siguientes pasos#

Requisitos

Entornos

Configura las URLs de webhook y de redirección

Crear un checkout

Crear la URL del formulario de pago

Consultar los detalles de un checkout

Siguientes pasos