Delivering to your funding account

This is the second of the two settlement movements: the real money, the collected funds traveling to your funding account, the actual bank account backing your program. This movement is Mono's job and never blocks the first one (the ledger credit your users see, covered in Crediting the subaccount). It runs behind it, on its own schedule, and reports through its own fields and webhooks.

Per-payin tracking

Every payin tracks its own delivery:

• funds_delivery_status: null until the payin is approved_in_provider, then pending_to_deliver → processing → completed.
• funds_destination: funding_account means the funds reach you through a settlement batch; method_receiving_account means the delivery completes immediately and the payin never appears in a settlement batch.
• settlement_batch_id: the batch that delivered the funds, once one covers this payin.

Settlement batches

Mono delivers your funds in settlement batches. Three things to expect when you reconcile:

1. One batch covers many payins: they share a settlement_batch_id, and total_amount is the sum of their funding_amount.
2. A single day can produce several batches.
3. A payin approved late in the day may arrive in the day's last batch instead of an earlier one.

Batch lifecycle

Each of these states is notified through a webhook. When you read a batch you may also see retryable or failed: Mono is handling the delivery, and you do not need to act. Neither state is notified.

Reading a batch

GET /v1/core/payins/settlement_batches/{id} returns the batch with its covered payins: what each one collected (amount), what it delivers (funding_amount), and the funding_amount_rates behind the conversion when the currencies differ (empty today, since everything is COP). The response is the same shape the payin_settlement_batch_* webhooks deliver. The list endpoint reports payins_count per batch.

Next steps

• Settlement flow: the end-to-end walkthrough with webhooks.
• Crediting the subaccount: the first movement.
• Settlement batches API reference: the full schemas.