Webhook (Notificación de pago)

Estos servicios son publicados por el sistema interno del comercio y consumidos por QR-Comercio para notificar pagos realizados sobre QR generados.

Actualmente se define un webservice principal:

• Recibir Pago QR

Recibir Pago QR

Notifica al sistema interno que se ha realizado un pago en la entidad financiera asociado a un QR.

• Publica: Sistema Interno

• Consume: QR-Comercio

• Método: POST

• Endpoint: <definir por el sistema interno>

---

Request

{
  "qrPagado": {
    "idTrans": "1",
    "idQrInterno": "16",
    "idQr": "19071801111000000011",
    "codMoneda": "604",
    "importe": "1700",
    "glosa": "Tramite CI",
    "fechaVencimiento": "2019-12-31",
    "usoUnico": false,
    "codServicio": "12345",
    "codOperacion": "9999999999",
    "codEif": "1111",
    "cuentaAbono": "12345678900000",
    "estado": "ACEP",
    "pos": "0",
    "cajero": "admin",
    "canal": "web",
    "sisOrigen": "SO_1",
    "pago": {
      "idTxPagoEif": "56",
      "idTxPagoQR": 65455456,
      "codMoneda": "604",
      "importe": 1700,
      "fechaPago": "2019-07-19",
      "estado": "PAGADO",
      "codEifOrigen": "2222",
      "ciNitOrigen": "6726252",
      "titularOrigen": "Jaime Castro"
    },
    "info": null
  }
}

Campos importantes

• qrPagado: objeto principal con:

  • Datos del QR (idQr, idQrInterno, idTrans, importe, glosa, etc.).

  • Estado (estado: ACEP/RECH/ERROR).

  • Datos del pago en pago:

    • idTxPagoEif, idTxPagoQR, importe, fechaPago, estado (normalmente "PAGADO").

    • Datos del pagador (codEifOrigen, ciNitOrigen, titularOrigen).

  • Campo libre info para información adicional (deudas, referencias, etc.).

Response

{
  "header": {
    "codReturn": "0",
    "txtReturn": "SUCCESS"
  }
}

• El sistema interno debe devolver codReturn = "0" para indicar que procesó exitosamente la notificación de pago.