DESCRIPCIÓN
PagoFacil proporciona una API tipo REST para integrar pagos SPEI en diversas aplicaciones. Una vez generada la cuenta clabe, le llegará un correo electrónico al cliente con el cual puede realizar el pago desde su banca móvil o web.
MÉTODOS DE INTEGRACIÓN
URL
Base de la URL que va a consumir todos los servicios web.
Stage/Pruebas - https://sandbox.pagofacil.tech
Producción - https://api.pagofacil.tech
1. Crear una cuenta clabe.
Esta API te Permite crear una cuenta clabe para que el cliente proceda a realizar el pago desde su banca móvil o web.
Método | URL | POST | /Stp/cuentaclave/crear |
---|
Campos de la petición:
Campo | Tipo | Longitud | Descripción |
---|---|---|---|
Nota 1: Formato de la fecha_expiracion (2022-04-21), el campo de fecha_expiracion puede ser opcional, si no colocas fecha de expiración, la cuenta clabe es válida por 3 meses |
|||
idSucursal | String | 100 | Api key de la sucursal |
idUsuario | String | 100 | Api key usuario |
monto | Decimal | (8,2) | Monto a pagar. |
id_pedido | String | 45 | Dato para identificación de la orden de compra |
concepto | String | 100 | Descripción o nombre del producto |
String | 100 | Correo electrónico del comprador | |
fecha_expiracion | Datetime | – | Fecha limite de pago de la cuenta clabe (fecha de expiración ).1 |
Ejemplo de la petición API:
{
"idSucursal":"e147ee31531d815e2308d",
"idUsuario":"f541b3f11f0f9b3fb3349",
"monto":"1.0",
"id_pedido":"75464",
"concepto":"Playera",
"email":"[email protected]"
"fecha_expiracion":"2022-04-21",
}
Campos de la respuesta:
Campo | Descripción |
---|---|
“error”: | En caso de realizar una petición exitosa, regresará “” |
“cuenta_clabe”: | Cuenta clabe generada por PagoFacil. |
“monto”: | Cantidad monetaria por la que se debe procesar dicha transacción. |
Ejemplo de la respuesta JSON:
{
"error" : "",
"cuenta_clabe" : "646180232600100201",
"monto" : "30"
}
Ejemplo de la respuesta con Error JSON:
{
"errors": {
"monto": "Falta el campo: 'monto'",
"concepto": "Falta el campo: 'concepto'",
"id_pedido": "Falta el campo: 'id_pedido'",
"email": "Falta el campo: 'email'"
}
}
A continuación, un ejemplo de la notificación que se debe mostrar al cliente final Cuenta Clabe: