Contabilidad de ledger
Registra transacciones de partida doble con holds y settlements.
Una transacción de ledger es la unidad de contabilidad en Core: un par balanceado de entradas de débito y crédito que juntas describen un movimiento de dinero. Cada cambio a los saldos pasa por una transacción de ledger — no hay forma de subir un saldo en silencio, y no hay forma de perder rastro de dónde vino el dinero o hacia dónde fue.
Este flujo cubre los patrones que vas a usar con más frecuencia: registrar una transacción simple de dos entradas, retener fondos antes del settlement, liquidar un hold y revertir una entrada cuando algo sale mal.
Esta página es un esqueleto de flujo. La versión completa incluirá snippets de código para cada patrón, un diagrama de secuencia en Mermaid y un ejemplo trabajado de conciliación.
Antes de empezar
Vas a necesitar una API key de Core, dos o más cuentas de ledger entre las cuales mover fondos y una clave de idempotencia por cada intento de registro.
Patrones
Registrar una transacción
El patrón más simple: debitar una cuenta, acreditar otra, ambas en la misma divisa, ambas por el mismo monto. La transacción se registra atómicamente — ambas entradas aterrizan o ninguna lo hace.
Hold y settle
Para autorizaciones de tarjeta y cualquier caso donde te comprometes a un débito futuro, primero registra un hold y luego ejecuta un settle. El hold reserva fondos; el settle convierte la reserva en un débito permanente. Si el hold no se liquida dentro de su ventana, expira y los fondos se liberan.
Revertir una transacción
Los reversos deshacen una transacción registrada registrando su imagen espejo. El original se preserva — el ledger de Core es append-only — para que la traza de auditoría se mantenga intacta.
Cross-currency
Cuando las cuentas de débito y crédito están en distintas divisas, la transacción debe referenciar una tasa FX.
Pasos
El paso a paso completo (con código) está pendiente. Hasta que se publique, ver la página de concepto de Ledger y la referencia de API de ledger de Core.
Siguientes pasos
- Emisión de tarjetas — las tarjetas gastan a través de holds y settlements del ledger.
- Dispersión — las dispersiones son transacciones de ledger más un riel.
- Buenas prácticas — patrones de conciliación.