Bancamiga
Introducción
Este documento proporciona las especificaciones para implementar los métodos de pagos de Bancamiga a través del API de Luka.
La URL está especificada en Ambientes.
La autenticación se realiza a través de un token (JWT) que retorna el método de login con las credenciales proporcionadas por Lukapay. Ver documentación.
Métodos de Pago
Pago Móvil
Permite registrar y validar pagos realizados a través de la modalidad de pago móvil.
Request
POST {URL}/api/v1/Transaccion/bancamiga.movpay
Headers
Authorization: Bearer {token}
userIp: {dirección IP del cliente}
Request body
| Nombre del campo | Descripción | Tipo | Obligatorio |
|---|---|---|---|
| nombrePagador | Nombre del cliente | String | No |
| codigoBancoPagador | Código de 4 dígitos del banco | String | Sí |
| telefonoPagador | Número de teléfono desde donde se realizó el pago móvil | String | Sí |
| cedula | Cédula de identidad del cliente | String | No |
| numeroRerefencia | Código de autorización del pago móvil | String | Sí |
| monto | Monto de la operación | Number | Sí |
| Correo electrónico del cliente | String | Sí | |
| referencia | Valor opcional que permite identificar algo relacionado con el pago | String | No |
| trazaId | Identificador único de trazabilidad en la base de datos del comercio | String | No |
| Tipo | Constante que indica si el pago móvil es enviado o recibido. Posibles valores: R=RECIBIDO, P=ENVIADOS. Valor por defecto: R | String | Sí |
Response
Response body
| Nombre | Descripción | Tipo |
|---|---|---|
| Canal | Indica el canal que se está utilizando para aplicar el pago en Lukapay | Number |
| CargosAdicionales | Objeto que contiene cargos adicionales. | Object |
| Cuotas | Objeto que contiene información sobre cuotas. | Object |
| Descripción | Contiene la respuesta de la aplicación del pago, como estatus de la transacción y cualquier información adicional | String |
| Exitoso | Indica si la transacción fue exitosa o no. Se utiliza para validar la respuesta | Boolean |
| FechaOperacion | Fecha que ocurrió la transacción | String |
| InfoProceso | Objeto que contiene información más detallada del estatus de la transacción | Object |
| InfoTarjeta | Objeto que contiene información de la tarjeta de crédito utilizada para realizar el pago. Solo aplica para pagos con tarjeta | Object |
| InfoUsuarioPagador | Objeto que devuelve información básica del usuario que realiza el pago | Object |
| MedioDePago | Indica el método de pago que se utilizó | String |
| MerchantId | Referencia de la transacción del merchant utilizado para aplicar el pago | String |
| Moneda | Código de la moneda utilizada para realizar el pago | String |
| Monto | Indica el monto del pago realizado | Number |
| MontoOriginal | Objeto con información del monto original. Se utiliza cuando se debe aplicar una conversión de moneda | Object |
| MontoUsd | Valor del monto en dólar estadounidense. Se utiliza cuando se especifica el MontoOriginal | Number |
| TarjetaHabiente | Objeto que contiene información del pagador (en caso de haber sido especificado) | Object |
| TransaccionId | Referencia de la transacción en Lukapay | Number |
| TransaccionMerchantId | Referencia de la transacción del merchant utilizado para aplicar el pago | Number |
| TrazaId | Identificador interno del comercio. En caso de que el comercio no lo proporcione se genera un código aleatorio. | String |
Los atributos de los objetos están especificados en Respuesta de transacción.
Ejemplo de uso
Request body
{
"nombrePagador": "Pedro Perez",
"codigoBancoPagador": "0105",
"telefonoPagador": "584125555555",
"cedula": "V 12345678",
"numeroRerefencia": "30867220134",
"monto": 1.0,
"email": "email@example.com",
"referencia": "",
"trazaId": "",
"tipo": "R"
}
Response body
{
"monto": 0,
"montoUsd": 0,
"infoProceso": {
"estatusProcesamiento": "string",
"codigoRespuestaCvv": "string"
},
"tarjetaHabiente": null,
"infoUsuarioPagador": {
"nombre": "string",
"apellido": "string",
"numeroIdentidad": "string",
"numeroTelefono": "string",
"email": "string"
},
"moneda": "string",
"infoTarjeta": null,
"transaccionId": 0,
"transaccionMerchantId": 0,
"descripcion": "string",
"trazaId": "string",
"exitoso": true,
"canal": "string",
"medioDePago": "string",
"montoOriginal": null,
"merchantId": "string",
"fechaOperacion": "string",
"cargosAdicionales": null
}
Códigos de error
| Código | Mensaje |
|---|---|
| 401 | acceso no autorizado |
| 400 | el pago ya fue registrado |
| 400 | el número de teléfono no tiene el formato correcto |
| 400 | el código del banco es incorrecto |
| 400 | la moneda no está soportada |
| 500 | ocurrió un error inesperado |
{
"mensaje": "string",
"codigo": 0,
"continua": true,
"mensajeId": "string"
}
Webhooks para pagos diferidos
Nuestra plataforma valida en línea la referencia de pago registrada por el usuario. Si no se encuentra automáticamente, la transacción se marca como "Pendiente por revisión" y se reintenta hasta 5 veces cada 2 minutos. Si aún no se encuentra, se revisa manualmente. En estos casos, el usuario es notificado por correo. En la integración, el campo Exitoso será true, pero se debe verificar InfoProceso.EstatusProcesamiento para conocer el estatus real del pago: success (exitoso) o pending (pendiente). El estatus final se envía a través de un webhook.