For the complete documentation index, see llms.txt. This page is also available as Markdown.

Settlement

Settlement is the stage that credits reconciled cross-border funds into the merchant's Global Collections balance, making them available for conversion and payout.


Settlement period

  • The merchant has a settlement period (T) with a start time, both configured by NeoX.

  • A settlement runs only when the merchant has at least one successful reconciliation in the period.

Example: if (T) is 3 days starting on the 10th of the month, all reconciliations completed between the 10th and the 13th are settled on the 13th.

Settlement process

When a settlement runs:

  • The settled reconciliations' status changes to "Paid".

  • The merchant's Global Collections balance is credited with the reconciled amount, in the currency of each reconciliation.

  • The settled amount is removed from the pending (unsettled) collection total.

After settlement

Once funds are settled, the merchant can:

  • Check the balance — call Get Account Balance (GET /v2/gc/accounts/balance) per currency, or view it on the Merchant Portal.

  • Convert currency — lock a rate and execute a trade via the FX APIs.

  • Pay out funds — register a beneficiary and initiate a payout via the Payout Request APIs.

Multi-currency note

Settlement is performed per currency. Each currency balance settles on its own reconciliations; there is no implicit conversion at settlement time. Convert between currencies explicitly with the FX APIs when required.

Viewing settlement status

To check which reconciliations have the "Paid" status, log in to the Merchant Portal, choose the Global Collections service, then open Reconciliation report. To view the credited balance, open Collection account.

Last updated

Was this helpful?