Entrega a tu cuenta de fondeo

Este es el segundo de los dos movimientos de liquidación: el dinero real, los fondos recaudados viajando a tu cuenta de fondeo, la cuenta bancaria real que respalda tu programa. Este movimiento es trabajo de Mono y nunca bloquea el primero (el crédito en el ledger que ven tus usuarios, cubierto en Crédito a la subcuenta). Corre detrás de él, con su propio calendario, y reporta por sus propios campos y webhooks.

Rastreo por pago

Cada pago rastrea su propia entrega:

• funds_delivery_status: null hasta que el pago queda approved_in_provider, luego pending_to_deliver → processing → completed.
• funds_destination: funding_account significa que los fondos te llegan en un lote de liquidación; method_receiving_account, que la entrega se completa de inmediato y el pago nunca aparece en un lote de liquidación.
• settlement_batch_id: el lote que entregó los fondos, cuando uno cubre este pago.

Lotes de liquidación

Mono te entrega los fondos en lotes de liquidación. Al conciliar, ten en cuenta tres cosas:

1. Un lote cubre muchos pagos: comparten settlement_batch_id, y total_amount es la suma de sus funding_amount.
2. Un mismo día puede producir varios lotes.
3. Un pago aprobado tarde en el día puede llegar en el último lote del día en vez de uno anterior.

Ciclo de vida del lote

Cada uno de estos estados se notifica por webhook. Al leer un lote también puedes ver retryable o failed: Mono se está encargando de la entrega y no necesitas hacer nada. Ninguno de los dos se notifica.

Leer un lote

GET /v1/core/payins/settlement_batches/{id} devuelve el lote con sus pagos cubiertos: lo que cada uno recaudó (amount), lo que entrega (funding_amount) y las funding_amount_rates detrás de la conversión cuando las monedas difieren (vacías hoy, porque todo es COP). La respuesta tiene la misma forma que entregan los webhooks payin_settlement_batch_*. El endpoint de listado reporta payins_count por lote.

Siguientes pasos

• Flujo de liquidación: el recorrido de extremo a extremo con webhooks.
• Crédito a la subcuenta: el primer movimiento.
• Referencia de API de lotes de liquidación: los schemas completos.