🧮 Conciliación, clearing y settlement¶
Las cinco fuentes¶
flowchart LR
O[Orden] --> R{Motor de conciliación}
P[Proveedor / adquirente] --> R
L[Ledger interno] --> R
S[Reporte de settlement] --> R
B[Cuenta bancaria] --> R
R --> M[Matched]
R --> E[Excepción con owner]
Conciliar solo API contra DB confirma coherencia técnica, no que el dinero llegó. El cierre financiero necesita el reporte de liquidación y el abono/débito bancario.
Claves y tolerancias¶
Prioriza identificadores exactos: provider transaction, merchant reference, capture/refund ID, batch y bank reference. Luego monto bruto, fee, impuesto, reserva, neto, moneda, fecha de proceso y fecha valor. Las tolerancias deben corresponder a redondeo/FX documentado; nunca una tolerancia amplia para esconder diferencias.
Modelo de diferencias¶
| Tipo | Ejemplo | Acción |
|---|---|---|
LOCAL_ONLY |
intento local sin registro remoto | consultar, revisar pre-envío, cerrar o escalar |
REMOTE_ONLY |
proveedor cobró sin registro local | contener payout, reconstruir intento y contabilizar |
AMOUNT_MISMATCH |
captura/abono difiere | revisar partial capture, tip, fee, FX o error |
CURRENCY_MISMATCH |
moneda inesperada | detener y revisar routing/configuración |
STATE_MISMATCH |
local captured, remoto reversed | sincronizar mediante transición compensatoria |
FEE_MISMATCH |
MDR/fee distinto | verificar pricing, impuestos y lote |
SETTLEMENT_MISSING |
capturado sin abono esperado | abrir caso por lote y antigüedad |
DUPLICATE |
dos referencias para una intención | evaluar doble efecto y refund controlado |
Ledger ilustrativo¶
Venta por 10.000 CLP con fee de 300 CLP:
| Cuenta | Débito | Crédito |
|---|---|---|
| receivable del adquirente | 10.000 | 0 |
| venta/pasivo del comercio | 0 | 10.000 |
Al liquidar:
| Cuenta | Débito | Crédito |
|---|---|---|
| banco | 9.700 | 0 |
| gasto/comisión | 300 | 0 |
| receivable del adquirente | 0 | 10.000 |
El chart real depende del rol, contabilidad y regulación. Refund, chargeback, reserva y payout son nuevos journals vinculados, no mutaciones del asiento original.
Pipeline diario¶
- Ingerir archivos/API de proveedor de forma inmutable y registrar checksum.
- Validar esquema, zona horaria, moneda, signo y completitud.
- Normalizar sin perder el registro crudo.
- Hacer matching determinista y luego reglas secundarias auditables.
- Crear excepciones con severidad, owner y SLA.
- Comparar totales de control antes/después.
- Vincular settlement con movimiento bancario.
- Publicar aging y bloquear payouts cuando el riesgo lo requiera.
- Resolver mediante evidencia/asiento compensatorio.
- Retener artefactos según política.
Controles¶
- segregación entre quien integra, concilia y aprueba ajuste/payout;
- archivos cifrados, firma/checksum y acceso mínimo;
- invariantes de cantidad y suma por moneda/lote;
- rerun idempotente;
- no cerrar automáticamente diferencias solo por antigüedad;
- dashboard de monto y edad, no solo conteo;
- evidencia del settlement final conforme a las reglas del sistema. Los PFMI de CPMI-IOSCO son la referencia internacional para infraestructuras de mercado.