Versión: v1.3
Fecha: 09-10-2025
Plataforma: UPAGO
Este documento especifica y guía el proceso de integración del botón de pago Conciliación en la plataforma del cliente.
Detalla las consideraciones, restricciones y lógica operativa del proceso transaccional para efectuar operaciones de recaudación a través de la cuenta bancaria del cliente.
UPago ha dispuesto su Botón de Pago Conciliación, el cual permite que los usuarios del cliente realicen pagos de productos o servicios mediante transferencias bancarias, y que el sistema reconozca automáticamente el abono asociado.
El flujo de pagos en Conciliación sigue una secuencia lógica, descrita a continuación.
Para iniciar una solicitud de reconocimiento de pago vía transferencia bancaria, el cliente debe realizar una solicitud POST:
Ambiente de certificación:
https://certif.upago.cl/payment/br/reconciliation/v1.3/operationrequest
Ambiente de producción:
https://pay.upago.cl/payment/br/reconciliation/v1.3/operationrequest
Cabecera de seguridad:
| Nombre | Valor |
|---|---|
| Authorization | Bearer TOKEN_DE_SEGURIDAD_DE_CLIENTE |
TOKEN_DE_SEGURIDAD_DE_CLIENTEes provisto por UPago y autentica la comunicación entre ambas plataformas.
Tabla 1 – Objeto principal
| Atributo | Ejemplo | Descripción |
|---|---|---|
| transactionIdOnClient | ABCDE4567 | ID único de operación del cliente |
| amount | 235000.00 | Monto esperado |
| currency | CLP | Tipo de moneda |
| customer | (ver Tabla 2) | Datos del cliente |
| consumptions | (ver Tabla 3) | Consumos asociados |
Tabla 2 – Cliente
| Atributo | Ejemplo | Descripción |
|---|---|---|
| remoteId | 15615145-9 | Identificador |
| name | Felipe Godoy | Nombre |
| nationalId | 15615145-9 | RUT o ID |
| example@gmail.com | ||
| mobile | 56956751239 | Teléfono |
Tabla 3 – Consumos
| Atributo | Ejemplo | Descripción |
|---|---|---|
| remoteId | C-1 | ID del consumo |
| description | Compra Oficina | Detalle |
| items | (ver Tabla 4) | Ítems asociados |
Tabla 4 – Ítems de Consumo
| Atributo | Ejemplo | Descripción |
|---|---|---|
| remoteId | DEBT-1789 | ID del ítem |
| description | Cuota Enero 2020 | Descripción |
| amount | 320000.00 | Monto |
| penaltyAmount | 32000.00 | Intereses |
| penaltyDays | 30 | Días mora |
| readjustmentAmount | 1500.00 | Reajuste |
| balance | 356700.00 | Saldo |
| issueDate | 2020-01-01 | Emisión |
| expirationAt | 2020-01-10 | Vencimiento |
Tabla 5 – Respuesta
| Atributo | Ejemplo | Descripción |
|---|---|---|
| url | https://pay.upago.cl/payment/br-conciliation-payment-instruction.xhtml | URL redirección |
| token | 20250109142506708C222887 | Token único |
El cliente debe redirigir al usuario a la URL devuelta por UPago con un formulario POST.
Ejemplo:
UPago provee un ejemplo HTML durante la habilitación.
Cuando se detecta un pago exitoso, UPago notificará al cliente mediante una solicitud POST segura (HTTPS).
Cabecera de seguridad:
| Nombre | Valor |
|---|---|
| Authorization | TOKEN_DE_SEGURIDAD_DE_CLIENTE |
Estructura JSON – Pago Recibido (Tabla 6)
| Atributo | Ejemplo | Descripción |
|---|---|---|
| transactionId | 20190225141000520C4 | ID de transacción UPago |
| token | 3C469E9D6C58... | Token asociado |
| paymentAt | 2019-02-25T20:10:00.000Z | Fecha del pago |
| amount | 235000.00 | Monto pagado |
| currency | CLP | Moneda utilizada |
| status | PAID | Estado del pago |
| itemsPaid | (ver tabla siguiente) | Ítems liquidados |
| gatewayResponse | (ver Tabla 7) | Datos de la pasarela |
Una vez completado el pago, UPago redirige al usuario mediante una solicitud GET segura (HTTPS) a la URL configurada.
Parámetro GET incluido:
| Parámetro | Ejemplo | Descripción |
|---|---|---|
| token | 3C469E9D6C58... | Token de la operación previa |
El cliente debe utilizar el token para identificar la operación y mostrar al usuario el resultado.
Posibles estados:
| Estado | Descripción |
|---|---|
| PAID | Pago recibido exitosamente |
⚙️ Nota:
La plataforma del cliente debe responderHTTP 200 OKa cada notificación.
En caso contrario, UPago reenviará hasta 5 intentos cada 30 segundos.
| Fecha | Versión | Descripción breve | Autor | Cargo |
|---|---|---|---|---|
| 09-10-2025 | 1.3 | Revisión técnica y ajustes finales de integración | Marco Betancourt | Jefe de TI |