Money flow and settlement
How a payment moves from authorisation to the merchant's bank account, who pays the merchant out, and how you reconcile.
A card payment goes through the same stages on every processor: authorisation, capture, clearing and settlement, and the payout to the merchant. Ginger handles the first two, the processor clears and settles, and the payout to the merchant is done either by the processor or by your platform with Ginger Payout.
The stages
| Stage | What happens | Where you see it |
|---|---|---|
| Authorisation | The issuer approves the amount. For a sale, the amount is captured at once. | The transaction becomes accepted. See Statuses. |
| Capture | A pre-authorised amount is captured: by the merchant, or automatically with delayed capture. | A linked capture order. See Capture modes. |
| Clearing and settlement | The processor clears the transaction with the scheme and settles the funds, with the interchange and scheme fees. | The settlement report of the processor. |
| Payout | The merchant receives the funds, minus fees, refunds, chargebacks and reserves. | Your processor's payouts, or the payouts of Ginger Payout. |
Refunds and chargebacks run the other way: they're deducted from the next settlement or payout. See Chargebacks and disputes.
Who pays the merchant
The processor pays the merchant directly, or your platform pays the merchant out with Ginger Payout. Ginger Payout handles transactions processed through Silverflow, in euros, and pays out the merchants and projects that have a payout configuration. See Payouts and fees.
The card contracts also have a payout_ field:
| Payout model | Who pays the merchant |
|---|---|
distributing (default) | The processor pays the merchant directly |
collecting | Your platform pays the merchant out |
See Fields on merchants and contracts.
Reconcile
To match your settlement with the payments on your platform, use the references Ginger stores on each transaction:
- Silverflow: the network transaction ID, the retrieval reference number and the approval code, in the payment method details of the transaction. See Silverflow.
- Elavon: the settlement ID in the Elavon settlement file. See Settlement IDs.
- Rapyd, Shift4 and IPG: the settlement report of your processor. Which reference to match on differs per processor: check its settlement report.
- Your own systems: follow every new and changed order with the Stream API, or export orders and transactions with the Search API.
Your merchants reconcile with the transaction report in the payment acceptance docs.