Si lo que deseas ver es cómo realizar cobros/venta directa
te invitamos a revisar esta documentación donde explica
paso a paso como poder hacerlo.
https://docs.pixelpay.app/docs/es/sdk/use-cases#payments
1. Estructura del campo content
El campo content
contiene un arreglo a detalle de cada elemento de la orden, a continuación mostraremos los campos de cada elemento:
Campo | Valor | Validación | Descripción |
title * |
Texto corto | Requerido, min:3, max:60 | Título del producto/factura |
code |
[A-z][0-9] | Opcional | Código o número de producto/factura |
price * |
0.00 | Requerido, double | Precio unitario |
qty * |
1 ... n | Requerido, int, unsigned | Cantidad de elementos |
tax |
0.00 | Opcional, double | Impuesto total del producto en moneda |
total * |
0.00 | Requerido, double | Total sin impuesto del producto x cantidad en moneda |
*
Campos requeridos
Ejemplo • Elementos de una orden
[
{
"code" : "0000123",
"title" : "Camiseta Roja",
"description" : "Talla: XS",
"tax" : 9.99,
"price" : 99.99,
"qty" : 1,
"total" : 9.99
},
{
"code" : "0000123",
"title" : "Jeans Pepe",
"description" : "Talla: 32",
"tax" : 0.00,
"price" : 123.99,
"qty" : 1,
"total" : 123.99
},
...
]
2. Webhook URL de Éxito
La URL de Éxito se ejecutará cada vez que un cobro se haya pagado con éxito, él request
es de tipo POST
y su contenido es content-type: application/json
.
La URL remota deberá de retornar una respuesta de código 200
para indicar que se capturó el contenido.
En caso de un código de respuesta distinto o no obtener respuesta de la URL remota, se reprogramara el envío de datos con un retraso de 5 min y un máximo de 3 intentos por envío.
El formato del campo extra
es opcional y puede ser de estructura escalable.
Ejemplo • Objeto JSON de URL de Éxito
{
"ref": "REF-0001-0006350867",
"uuid": "1dab5ed0",
"status": "paid",
"description": null,
"note": null,
"currency": "USD",
"tax_amount": 9.99,
"amount": 99.99,
"items": [{
"code" : "0000123",
"title" : "Camiseta Roja",
"description" : "Talla: XS",
"tax" : 9.99,
"price" : 99.99,
"qty" : 1,
"total" : 9.99
}],
"customer_name": "PEDRO PEREZ",
"customer_email": "pedro.perez@gmail.com",
"customer_phone": null,
"client_ip": "180.125.81.220",
"client_device": "android",
"created_at": "2017-09-25 03:09:47",
"paid_at": "2017-10-30 04:10:13",
"transaction_id": "7398009601",
"card_account": "4234 •••• •••• 1234",
"card_brand": "visa",
"card_type": "debit",
"company_name": "My Company",
"company_slug": "my_company",
"company_key": "7812290000",
"is_overdue": false,
"payment_url": "https://www.pixelpay.app/my_company/1dab5ed0/checkout",
"attach_url": null,
"extra": {
"codigoCliente" : "4782164",
"codigoNegocio" : "ATGSH-6712",
}
}
3. Webhook URL de Error
La URL de Error se ejecutará cada vez que un cobro falle o exista un Exception
en el código devolviendo un mensaje con el detalle técnico listo para ser reportado al soporte técnico de PixelPay.
Devuelve una estructura de tipo json
de la siguiente forma:
Ejemplo • Objeto JSON de URL de Error
{
"success": false,
"message": "Fatal error: Maximum execution time of 30 seconds exceeded"
}
Comentarios
0 comentarios
Inicie sesión para dejar un comentario.