Balance
Your Mollie balance is the central ledger for all money flowing through your account. Understanding it is fundamental to building reliable reconciliation, reporting, and cash-flow tools with Mollie.
Overview
Every Mollie account has at least one balance: the primary balance. When a customer pays, the funds move through two states before they can be paid out:
- Pending (
pendingAmount) — Funds received but not yet available. Mollie holds these during the settlement period, which varies by payment method. - Available (
availableAmount) — Funds ready to be paid out or used for refunds.
Customer pays → pendingAmount → settlement delay → availableAmount → payout to bankRetrieve your balance at any time with the Balances API:
GET /v2/balances/primary
GET /v2/balances/{balanceId}Each balance object returns both availableAmount and pendingAmount, giving you a real-time view of funds in each state.
For a non-technical explanation of how the balance works, see When do I receive my money from Mollie?
Settlement delays
When Mollie receives a payment, it enters pendingAmount and stays there for a payment-method-specific delay before moving to availableAmount. This delay lets Mollie manage chargebacks and potential credit risks.
Standard settlement delays by payment method
| Payment method | API identifier | Standard settlement delay |
|---|---|---|
| iDEAL | ideal | Next business day (T+1) |
| Bancontact | bancontact | Next business day (T+1) |
| Belfius | belfius | Next business day (T+1) |
| KBC | kbc | Next business day (T+1) |
| Wero | wero | Next business day (T+1) |
| Pay by Bank | paybybank | 2 business days (T+2) |
| Bank transfer | banktransfer | 2 business days (T+2) |
| TWINT | twint | 2 business days (T+2) |
| EPS | eps | 3 business days (T+3) |
| MyBank | mybank | 3 business days (T+3) |
| Przelewy24 | przelewy24 | 3 business days (T+3) |
| Swish | swish | 3 business days (T+3) |
| Credit card | creditcard | 4 business days (T+4) |
| Apple Pay | applepay | 4 business days (T+4) |
| BANCOMAT Pay | bancomatpay | 4 business days (T+4) |
| BLIK | blik | 4 business days (T+4) |
| Klarna | klarna | 5 business days after capture (T+5)* |
| Alma | alma | 5 business days (T+5) |
| Bacs | bacs | 5 business days (T+5) |
| Billie | billie | 5 business days (T+5) |
| Riverty | riverty | 9 business days (T+9) |
| SEPA Direct Debit | directdebit | 9 business days (T+9) |
| in3 | in3 | 11 business days (T+11) |
| paysafecard | paysafecard | Monthly |
| PayPal | paypal | Settled directly by PayPal, not through Mollie |
| Gift card | giftcard | Settled by the gift card issuer, not through Mollie |
| Voucher | voucher | Settled by the voucher issuer, not through Mollie |
For Klarna, the settlement delay starts when the payment is captured, not when it is authorized. Funds do not enter
pendingAmountuntil capture.
Risk-applied settlement delays
In some cases, Mollie's risk team applies a longer settlement delay to specific Organizations or payment methods. This is separate from the standard delays and is communicated directly when applied.
If your integration communicates settlement timing to merchants, account for the possibility that pendingAmount remains pending longer than the standard period.
For more information, see How long does it take for a payment to be available for payout?
Rolling reserve
A rolling reserve is an additional safeguard where Mollie holds a percentage of each transaction in pendingAmount for a fixed period. For example, Mollie may hold 20% for 90 days.
Mollie's risk team applies a rolling reserve to specific organisations based on their risk profile. Rolling reserve funds appear in pendingAmount alongside regular settlement-delayed funds. Funds move to availableAmount daily after their holding period ends.
A rolling reserve is different from a balance reserve, which is a merchant-configured setting.
For more information, see What is a rolling reserve and how does it affect my payouts?
Balance reserve
A balance reserve is a configurable amount retained on your balance. Use it to make sure funds are available for refunds without requiring a top-up.
At payout time, Mollie deducts the reserve from availableAmount before initiating the payout:
payout amount = availableAmount − balance reserveYou can check and set the balance reserve in your balance settings. If availableAmount is less than the configured reserve at payout time, Mollie skips the payout.
For more information, see What is a balance reserve and how do I set one?
Additional balances
Your Mollie account can have more than one balance. Additional balances let you separate revenue streams by country, sales channel, or business unit. Each balance can have its own bank account, payout settings, and reporting.
Each balance is linked to a profile. Payments processed with a profile's API key are credited to the balance linked to that profile.
Retrieve all balances for an organization:
GET /v2/balancesRetrieve a specific balance:
GET /v2/balances/{balanceId}The primary alias always refers to the organisation's primary balance:
GET /v2/balances/primaryFor guidance on configuring multiple balances, see How do I set up additional balances for a Mollie account?
Multi-currency balances
By default, payments made in a currency that differs from your primary balance currency are converted and settled to your primary balance. If you hold a balance in the same currency as a payment, Mollie automatically settles the payment directly to that balance without conversion.
Multi-currency balances work like additional balances. Each currency balance is a separate balance object with its own availableAmount, pendingAmount, bank account, and payout settings.
GET /v2/balancesThis endpoint returns all balances, including multi-currency balances. Each balance object includes a currency field identifying its currency.
For supported payment currencies and payment-method availability, see Multicurrency. For payout currencies and eligibility requirements, see What are multi-currency payouts? How do I set up multi-currency payouts?
Balance reporting
Mollie provides two programmatic options for tracking balance movements over time:
| Option | Use it for |
|---|---|
| Balances API | Real-time balance state and historical movement data. Use it when your integration needs a complete picture of balance activities without waiting for payout execution. |
| Settlements API | Aggregated data for each payout. Use it to match a specific payout to its constituent transactions. |
For export-based reconciliation, balance reports are available in CSV, MT940, CODA, and DATEV formats on daily or monthly schedules.
See Balance Report for full documentation. For export instructions, see How do I export my balance report, transactions, and settlements?
Updated about 1 hour ago