Pago móvil
Permite consultar si un pago realizado a través de pago móvil existe.
Solicitud
POST {URL}/api/v1/Transaccion/bancamiga.movpay
Cabeceras
Authorization: Bearer {token}
userIp: {dirección IP del cliente}
Cuerpo de la solicitud
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í |
Respuesta
Cuerpo de la respuesta
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
Cuerpo de la solicitud
{
"nombrePagador": "Pedro Perez",
"codigoBancoPagador": "0105",
"telefonoPagador": "584125555555",
"cedula": "V 12345678",
"numeroRerefencia": "30867220134",
"monto": 1.0,
"email": "email@example.com",
"referencia": "",
"trazaId": "",
"tipo": "R"
}
Cuerpo de la respuesta
{
"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"
}