Checkout API
Genera links de checkout para tus clientes utilizando nuestra API. Recibe notificaciones cuando cambie el estado de una transacción. Crea cobros directos a tarjetas guardadas.
Esta sección cubre los conceptos básicos de los servicios y los detalles técnicos de la API REST de Directo Pago. Contiene ejemplos funcionales de las solicitudes y observaciones importantes que deben tenerse en cuenta durante la integración.
Todas las llamadas a la API devolverán respuestas JSON, incluidos errores.
Es recomendable que la integración se realice creando una cuenta en nuestro ambiente de pruebas, más información aquí.
Servicios
Checkout Creation
POST
https://checkout-api.directopago.com/v1/checkout
Headers
Request Body
Example request:
Simplest request Body (Creates a checkout for every supported country in USD):
Request Body for a specific country and currency:
Cobros con cardId
Para realizar un cobro con un cardId
guardado previamente mediante nuestra solución de Tokenización, se debe hacer de la siguiente manera:
Request Body:
Response Body:
Borrar tarjeta guardada:
Puedes consultar los posibles códigos de error de este servicio aquí.
Notificaciones de cambios de estado
Al crear un checkout, se permite enviar una URL a la cual se notificarán los cambios de estado que ocurran sobre la transacción creada.
Checkout creation with notification URL
POST
https://checkout-api.directopago.com/v1/checkout
Headers
Request Body
Example request:
Request body:
Ejemplo de notificación
POST
https://www.yoursite.com/directopago/ipn
Request Body
Cuando se recibe una notificación de cambio de estado, se debe consultar al siguiente servicio con su API Key correspondiente.
Transaction status
GET
https://checkout-api.directopago.com/v1/transactions/{invoiceId}
Path Parameters
Headers
Example request:
Estados posibles para una transacción: PENDING, COMPLETED, CANCELLED, DECLINED.
Puedes consultar los posibles códigos de error de este servicio aquí.
Para ver qué moneda y tipos de documento son válidos para cada país, accede aquí.
Última actualización