Checkout | Paggo
Crea una instancia de un link de pago, proporcionando un objeto de tipo Checkout Request.
Esta pasarela de pago solo soporta un formulario de pago Alojado, esto quiere decir que Paggo se hará cargo de toda la lógica del pago dentro de sus servidores.
Autenticación
Para poder autenticarse con el API de recurrente debes de proveer el token obtenido en la llamada de setup.
Payload
A continuación, puedes encontrar un ejemplo del cuerpo de esta llamada. Debajo podrás encontrar una tabla describiendo cada parámetro del cuerpo de la llamada.
Copiado!
{
"number": 23,
"description": "Prueba de Orden",
"amount": 150.5,
"currency": "GTQ",
"billing": {
"name" : "John",
"surname" : "Doe",
"taxId" : "2045520",
"email" : "[email protected]",
"phone" : "55555555",
"address" : "Guatemala City"
}
}
number (Int)
Requerido Representa el Identificador de tu orden de compra, puede ser cualquier valor numérico que funcione como identificador dentro de tu sistema.
description (String)
Requerido Esta descripción es mostrada al cliente durante el proceso de pago.
amount (Decimal)
Requerido Valor del costo de la orden de compra.
currency (String)
String que representa la moneda en la cual se realizará el cobro, los valores aceptados son GTQ.
Facturación.
Objeto que provee la información del cliente.
name (String)
Requerido Nombre del cliente.
surname (String)
Requerido Apellido del cliente.
taxId (String)
Número de NIT del cliente, dejar en blanco para CF.
email (String)
Requerido Email del cliente.
phone (String)
Teléfono del cliente.
address (String)
Dirección del cliente.
cUrl
Aquí hay un ejemplo de la llamada al API en cUrl.
Recuerda que debes de agregar en el header el parámetro de X-TOKEN con el token que retorna la llamada de steup.
Copied!
curl -X 'POST' \
'https://aurora.codingtipi.com/pay/v2/paggo/checkouts/hosted/single' \
-H 'accept: application/json' \
-H 'X-Token: add85aae-069a-404c-b0f2-bf006a323355' \
-H 'Content-Type: application/json'' \
-d '{
"number": 15,
"description": "Esta es una descripción",
"amount": 150.25,
"currency": "GTQ",
"billing": {
"name": "John",
"surname": "Doe",
"email": "[email protected]"
}
}'
Respuesta
Aquí puedes encontrar el objeto que retorna la llamada con status Created 201. El objeto que retornó contiene los parámetros que necesitas del checkout de paggo id que representa el id del checkout, metadata que contiene información adicional sobre el checkout y url que representa el URL del checkout, este parámetro es el que necesitas para redirigir al usuario hacia el checkout.
Copied!
{
"id" : "102276",
"url" : "https://url/PayWithLinkPayfac/EYVDVNBDWP",
"metadata" : {
"expiration" : "2025-01-01T00:00:00Z"
}
}
Códigos de Respuesta
Aquí puedes encontrar todos los posibles códigos de respuesta que el API puede contestar.