Merchant currency routing

Currency routing decides which settlement account a sale reaches. A node’s routing holds rules and a default. A rule sends one currency to another. The default is the currency for anything with no account and no rule.

Before you start

How a sale finds its account

The post tries four steps, in this order. Each step looks from the sale’s node up the tree. It stops at the node holding the agreement.

  1. Own currency. The nearest account in the sale’s currency.
  2. Rule. The nearest rule for the sale’s currency, if an account exists in the currency it names.
  3. Default. The nearest default, if an account exists in its currency.
  4. Nothing. The line goes to suspense as unroutable.

A step naming a currency with no account moves on to the next step. Rules never chain. A sale never reaches a sibling node’s account, or an account under another agreement.

A node with one account gets no special treatment. If a sale’s currency has no account, that node needs a rule or a default. Without one, the sale goes to suspense.

The rules in force on the sale date decide. The accounts open on the posting date are searched.

For example, ABC London sells for 100.00 USD on 3 November 2026. ABC UK holds only a GBP account, and the tenant rate is 1 GBP = 1.27 USD. No USD account exists, so the default sends the sale to ABC UK GBP. It is credited 78.74 GBP before fees, and the conversion fee applies. The amount rounds half away from zero, to the minor unit of the currency under ISO 4217.

When a sale converts

A sale converts only when the account’s currency differs from the line’s settlement currency. It converts at the tenant rate for the sale date. If the processor already settled the sale in the account’s currency, nothing converts and no conversion fee applies.

A sale takes the last rate published on or before its date, within one business day. If no such rate exists, the line waits. It posts on a later run once the rate arrives.

A refund and a first chargeback route on their own date and rate. So a refund can reach an account its sale never credited. Later chargeback stages keep the account of the first chargeback.

If it is refused

What you see What to do
The date is in the past Choose today’s trading date or later.
The routing is not valid Name a rule or a default. Do not send a currency to itself, or give one currency two rules.
A currency is not known Use a currency set up for your organisation.

Seeing the result

Open the outlet on the Outlets page. Effective routing shows, for each currency, the account a sale would reach and why. See outlets.

If a sale is unroutable

The line stays on the feed batch as No account, rule or default reaches the currency. Add a rule or a default, or open an account in the currency. The next post picks the line up.

What your organisation configures

From the LedgerTM product guide, as shipped with the software and written with it. Copied from the platform repository on 2026-11-11.