Liquidación

Recibir el pago es la mitad de la historia; este flujo cubre la otra mitad: cómo el dinero que enviaron los pagadores se convierte en saldo en tu cuenta bancaria. Recorre cómo Mono te entrega los fondos, los webhooks que reportan cada paso y qué debe revisar tu conciliación al final del día.

Si aún no has leído el concepto de Liquidación, empieza por ahí: esta página asume que sabes qué es un lote de liquidación.

Antes de empezar

Vas a necesitar:

• Pagos llegando a approved_in_provider (cualquiera de los flujos de recaudos los produce).
• Un endpoint de webhooks suscrito a los eventos payin_settlement_batch_*.

Cómo corre la entrega

1. Los pagos se acumulan. Cada pago aprobado con destino a tu cuenta de fondeo espera como pending_to_deliver.
2. Mono los agrupa en un lote. payin_settlement_batch_created lista exactamente qué pagos cubre el lote y cuánto entrega cada uno. Un mismo día puede producir varios lotes.
3. Corre la entrega. processing significa que la entrega está en curso; completed, que el dinero llegó a tu cuenta de fondeo. Si lees un lote en retryable o failed, Mono se está encargando y no necesitas hacer nada.
4. Los pagos quedan estampados. Cada pago cubierto recibe settlement_batch_id y funds_delivery_status: "completed".

Conciliar las liquidaciones

• Lote → extracto bancario: cruza cada payin_settlement_batch_completed con un crédito en tu extracto por total_amount.
• Lote → pagos: GET /v1/core/payins/settlement_batches/{id} devuelve los pagos cubiertos con su funding_amount. La suma es el total del lote, sin pago faltante ni repetido.
• Rezagados: un pago aprobado tarde en el día puede seguir en pending_to_deliver al cierre; llega en el último lote del día. Si un pago sigue sin entregarse por más de un día, contacta a soporte de Mono con su id.

Siguientes pasos

• Concepto de Liquidación: estados, agrupamiento y los campos involucrados.
• Pagos: los campos de entrega por pago.
• Webhooks: los tres eventos del lote de liquidación en contexto.