Documentation
Orders & payments5 min readUpdated 28 July 2026

Payments

Bring your own processor, keep your own rate, and reconcile settlements against orders without a spreadsheet.

On this page

The platform does not process payments and does not want a share of them. You connect the processor you have already negotiated with, and the rate you negotiated is the rate you pay.

Note

Processing fees are always charged by your processor. Any platform fee is charged by the platform. Check the current pricing page for the commercial terms that apply to your plan.

Connecting a processor

1
Add the processor credentials

Keys are stored encrypted per project and never returned through the API once saved.

2
Choose capture behaviour

Authorise-then-capture on fulfilment is the default and the right choice for physical goods. Immediate capture suits digital goods and pre-orders you intend to honour.

3
Assign processors to channels

Different channels can use different processors — a local acquirer for one market, a global one for another — without either channel knowing about the other.

4
Verify with a live transaction

A real card, a real refund, and a check that both appear against the same order.

Marketplace payments are different

On most marketplaces you do not take the payment at all; the marketplace does, and settles to you later, net of its commission. Those orders arrive already paid, and reconciliation happens against the marketplace payout rather than a card transaction.

Both models sit in the same order book, with the payment source recorded, so revenue reporting does not need you to remember which is which.

Reconciliation

Settlements are matched to orders automatically, and what does not match is listed rather than hidden.

SituationWhat you see
Settled in fullMatched, no action
Fee differenceMatched with a variance and the fee breakdown
Marketplace commissionMatched net, gross and commission shown separately
ChargebackLinked to the original order with its stage
Unmatched payoutQueued for review with candidate orders suggested

This is the reporting that quietly costs merchants a day a month elsewhere, usually in a spreadsheet nobody else can maintain.

Refunds and partials

A refund is issued against the order and executed through the original processor. Partial refunds carry a reason and a line reference, so margin reporting reflects what was actually returned rather than a lump adjustment at the end of the month.

Multi-currency

Prices can be set per currency in a price list or derived from a base currency with a rounding rule. The presentment currency is recorded on the order alongside the settlement currency, and reporting can be read in either.

Worth knowing

Derived pricing with automatic FX makes margins move without anyone deciding they should. On core lines, set explicit prices per currency and review them on a schedule.

Tax

Tax is calculated per destination against the rules configured for the project, and marketplace-facilitated tax is recognised as such rather than double-counted. Where a channel remits on your behalf, the order records who is liable.

Next: the API, if you want to drive any of this programmatically.

Ask about this page withChatGPTClaudePerplexity