Recaudos
Recibe dinero en tus subcuentas de Core: plantillas, intenciones de pago, pagos y liquidación.
Recaudos es la forma en que el dinero entra a tus subcuentas de Core. Cubre tanto las recargas (un usuario final carga saldo a su propia billetera) como los recaudos propiamente dichos (tu negocio le cobra a un cliente). Tú defines las reglas de lo que esperas recibir, Mono le entrega al pagador algo a lo cual pagar (hoy una llave Bre-B o un código QR) y cada pago que llega se valida, se acredita en la subcuenta correcta y se entrega en tu cuenta bancaria, con un webhook en cada paso.
Mono tiene tres productos que reciben dinero, para tres modelos de cuenta distintos. Recaudos de Core (esta sección) recauda hacia subcuentas de Core. Úsalo cuando tu producto maneja saldos en el ledger de Core. Los enlaces de recaudo recaudan hacia cuentas de Banking mediante links de pago PSE. Los recaudos de Bre-B Participant reciben pagos Bre-B directamente en cuentas de tenant. Ver Recaudos frente a otros productos para la comparativa completa.
Las cuatro entidades
Un pago nunca viaja solo. Cuatro entidades, cada una con su propio ciclo de vida y webhooks, llevan un pago de "esperado" a "dinero en tu cuenta bancaria":
| Entidad | Qué es |
|---|---|
| Plantilla | Una configuración reutilizable atada a una subcuenta. Define los métodos disponibles para recibir pagos, los límites de monto al recibir, los pagadores permitidos, la expiración y el checkout personalizado, entre otros. |
| Intención de pago | Un único pago esperado, declarado antes de que llegue el dinero. Úsala cuando cada pago debe identificarse de antemano. |
| Pago | El pago que efectivamente llega: quién pagó, cuánto, y en qué punto de su recorrido va el dinero. |
| Lote de liquidación | El movimiento único de dinero que entrega los fondos de muchos pagos en tu cuenta de fondeo. |
Dos conceptos de apoyo completan el mapa: los tokens de pago (aquello a lo que el pagador realmente paga) y los cargos (lo que tú le cobras a tus subcuentas por cada pago). Y dentro de cada pago viven tres sub-entidades propias (el instrument, el recipient data y el transaction data), explicadas en Pagos.
Los cuatro montos
Cada pago lleva cuatro montos, uno por cada tramo del recorrido del dinero. Cada tramo tiene su propia moneda, así que el modelo soporta recaudar en una moneda y contabilizar en otra:
| Campo | Qué mide | Denominado en |
|---|---|---|
amount | Lo que pagó el pagador, según lo liquidó el método de pago. | La moneda del método |
merchant_amount | El valor del pago de cara al comercio. | La moneda de la plantilla |
subaccount_amount | Lo que se acredita en la subcuenta. | La moneda de la subcuenta |
funding_amount | Lo que se entrega en tu cuenta de fondeo. | La moneda de la cuenta de fondeo |
Hacia dónde va el multi-moneda. Hoy el único método activo es Bre-B, que liquida en COP, así que los cuatro montos normalmente coinciden. La meta del modelo de cuatro tramos es el recaudo multi-moneda completo: recibir un pago en la moneda del método mientras el precio, el crédito a la subcuenta y la liquidación de tu cuenta de fondeo van cada uno en su propia moneda, con Mono encargándose de las conversiones entre tramos (a una tasa reservada de antemano o a la tasa live de Mono). Cuando llegue el recaudo multi-moneda, aterriza sobre estos mismos cuatro campos sin cambios que rompan tu integración.
Métodos de pago
Cada pago se recibe a través de un método de pago. Hoy hay un método disponible:
| Método | Riel | Moneda | El pagador paga con |
|---|---|---|---|
co_breb | Bre-B, el sistema de pagos inmediatos de Colombia | COP | Una llave Bre-B o un código QR |
La estructura crece por método: cuando se lance un método nuevo, aparecerá en Métodos con su propia página, y las plantillas lo aceptarán en available_methods sin ningún cambio en las entidades de arriba.
Explora
Recaudos frente a otros productos
Cómo se compara con los enlaces de recaudo de Banking y los recaudos de Bre-B Participant.
Plantillas
La configuración reutilizable que define cómo se recaudan los pagos.
Intenciones de pago
Un único pago esperado, declarado antes de que llegue el dinero.
Pagos
El pago recibido: estados, montos, sub-entidades y razones de rechazo.
Tokens de pago
Aquello a lo que paga el pagador. Cada método emite el suyo; hoy, llaves Bre-B y códigos QR.
Liquidación
Dos movimientos: cuándo se acredita la subcuenta y cómo Mono te entrega los fondos.
Cargos
El cargo sobre los pagos y cómo sobreescribirlo por plantilla.
Métodos
Los métodos de pago con los que puedes recaudar, lado a lado.
Flujos
Casos de uso de extremo a extremo: recargas, recaudo con llave estática, recaudo con intenciones de pago, liquidación.
Webhooks
Los 22 eventos del ciclo de vida del pago y cuándo llega cada uno.
Siguientes pasos
- Plantillas: empieza aquí: todo comienza con una plantilla.
- Flujos: elige el flujo que corresponde a tu caso de negocio.
- Referencia de API de recaudos: cada endpoint, petición y respuesta.