Documentación de API: Verificación de Pago Móvil (Meritop)

Endpoint: /api/v1/payments/bancoActivo/find-mobile-pay
Método: POST
Descripción: Este servicio permite consultar y validar un pago móvil realizado a través de la plataforma Meritop, utilizando los datos de la transacción para buscar coincidencias y registrar el pago en el sistema.

1. Headers (Cabeceras)

Key Value Descripción
Content-Type application/json Indica que el cuerpo de la solicitud es JSON.
api-key [HASH_TOKEN] Token hash MD5/SHA de autenticación.

2. Request Payload (Cuerpo de la Solicitud)

A continuación se muestra un ejemplo del JSON requerido.

{
  "xtelefono": "584241829583",
  "cbanco_ref": "0132",
  "cbanco_dest": "0171",
  "mmonto": "1",
  "fmovimiento": "2026-01-08",
  "telefono_dest": "04143966962",
  "cci_rif": "V-25221952"
}

3. Diccionario de Datos

Campo Tipo Longitud / Precisión Descripción Requerido
xtelefono String Varchar(12) Teléfono de origen. Formato internacional sin símbolo (ej. 58...). Sí
cbanco_ref String Varchar(4) Código del banco de origen. Sí
cbanco_dest String Varchar(12) Código del banco de destino. Sí
mmonto String/Numérico Decimal(18, 2) Monto exacto de la transacción. Sí
fmovimiento String/Date YYYY-MM-DD Fecha en la que se realizó el movimiento. Sí
telefono_dest String Varchar(12) Teléfono de destino (Hardcodeado/Fijo según integración). Sí
cci_rif String Varchar Cédula o RIF del pagador. Sí

4. Response (Respuesta Estimada)

Exitoso (200 OK)

{
  "code": 200,
  "Refpk": "12345678"
}

Errores Comunes

Código HTTP Respuesta JSON Causa Probable
401 {"status":false, "message": "Error en el token..."} Token de autenticación inválido o expirado.
201 {"status":201, "error": "Pago móvil ya registrado..."} El pago ya fue procesado anteriormente.
201 {"status":201, "error": "No se encontraron los datos..."} El pago no existe en Meritop o los datos no coinciden.
500 {"code": 500, "message": "Error..."} Error en el servidor o problema con la base de datos.

5. Instrucciones de Uso (Paso a Paso)

  1. Obtener Credenciales: Asegúrese de tener el token de autenticación (api-key) válido proporcionado por el administrador del sistema.
  2. Preparar Datos: Recopile los datos del pago móvil realizado por el cliente (referencia, banco origen, teléfono, monto exacto, fecha).
  3. Construir Payload: Arme el JSON siguiendo estrictamente el formato especificado en la sección "Request Payload". Asegúrese de que el formato de fecha sea YYYY-MM-DD.
  4. Enviar Solicitud: Realice una petición POST al endpoint /api/v1/bancamiga/meritop/find-mobile-pay incluyendo los headers requeridos.
  5. Analizar Respuesta: