Skip to main content

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 campoDescripciónTipoObligatorio
nombrePagadorNombre del clienteStringNo
codigoBancoPagadorCódigo de 4 dígitos del bancoString
telefonoPagadorNúmero de teléfono desde donde se realizó el pago móvilString
cedulaCédula de identidad del clienteStringNo
numeroRerefenciaCódigo de autorización del pago móvilString
montoMonto de la operaciónNumber
emailCorreo electrónico del clienteString
referenciaValor opcional que permite identificar algo relacionado con el pagoStringNo
trazaIdIdentificador único de trazabilidad en la base de datos del comercioStringNo
TipoConstante que indica si el pago móvil es enviado o recibido. Posibles valores: R=RECIBIDO, P=ENVIADOS. Valor por defecto: RString

Respuesta

Cuerpo de la respuesta

NombreDescripciónTipo
CanalIndica el canal que se está utilizando para aplicar el pago en LukapayNumber
CargosAdicionalesObjeto que contiene cargos adicionales.Object
CuotasObjeto que contiene información sobre cuotas.Object
DescripciónContiene la respuesta de la aplicación del pago, como estatus de la transacción y cualquier información adicionalString
ExitosoIndica si la transacción fue exitosa o no. Se utiliza para validar la respuestaBoolean
FechaOperacionFecha que ocurrió la transacciónString
InfoProcesoObjeto que contiene información más detallada del estatus de la transacciónObject
InfoTarjetaObjeto que contiene información de la tarjeta de crédito utilizada para realizar el pago. Solo aplica para pagos con tarjetaObject
InfoUsuarioPagadorObjeto que devuelve información básica del usuario que realiza el pagoObject
MedioDePagoIndica el método de pago que se utilizóString
MerchantIdReferencia de la transacción del merchant utilizado para aplicar el pagoString
MonedaCódigo de la moneda utilizada para realizar el pagoString
MontoIndica el monto del pago realizadoNumber
MontoOriginalObjeto con información del monto original. Se utiliza cuando se debe aplicar una conversión de monedaObject
MontoUsdValor del monto en dólar estadounidense. Se utiliza cuando se especifica el MontoOriginalNumber
TarjetaHabienteObjeto que contiene información del pagador (en caso de haber sido especificado)Object
TransaccionIdReferencia de la transacción en LukapayNumber
TransaccionMerchantIdReferencia de la transacción del merchant utilizado para aplicar el pagoNumber
TrazaIdIdentificador 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ódigoMensaje
401acceso no autorizado
400el pago ya fue registrado
400el número de teléfono no tiene el formato correcto
400el código del banco es incorrecto
400la moneda no está soportada
500ocurrió un error inesperado
{
"mensaje": "string",
"codigo": 0,
"continua": true,
"mensajeId": "string"
}