Skip to main content

How It Works

Each clearing system connection (BIC) maintains separate nostro accounts for SCT (SEPA Credit Transfer) and INST (SEPA Instant). The liquidity engine periodically checks these balances against your configured minimums and takes action when needed.

Balance Thresholds

You configure four values that control the engine’s behavior:

Configuration

Configure liquidity settings through the Dashboard under Settings > Liquidity.

Enable Auto-Liquidity

  1. Navigate to Settings > Liquidity
  2. Enable Auto-Liquidity
  3. Set SCT Minimum, INST Minimum, and Transfer Amount
  4. Optionally set a Warning Balance above the critical minimum
  5. Save the configuration

What-If Calculator

The settings page includes a what-if calculator. Enter hypothetical SCT and INST balances to see what the engine would do - which alerts fire, whether a transfer is triggered, and in which direction. Use the sliders to explore thresholds.

Automatic Transfers

When auto-liquidity is enabled and a scheme balance drops below its minimum, the engine:
  1. Checks if the opposite scheme account has enough surplus (its own minimum + transfer amount)
  2. If yes, initiates a transfer of the configured amount from the surplus account to the deficit account
  3. The transfer is sent to the clearing system as a dedicated liquidity transfer instruction, not a regular customer payment - it is recorded as an Adjustment transaction and cannot be cancelled or returned
Transfers only execute during the clearing system’s operating window. For SEPA via CENTROlink, this is typically 08:00-18:40 EET on business days.

Notifications

Configure webhook URLs to receive alerts when balance thresholds are breached or when automatic transfers occur.

Low Balance Notification

Payload
string
required
Which limit was breached. One of: RECOMMENDED_TOTAL_MINIMUM_BREACHED, ABSOLUTE_TOTAL_MINIMUM_BREACHED, SCT_MINIMUM_BREACHED_NO_TRANSFER, INST_MINIMUM_BREACHED_NO_TRANSFER
array
required
IBANs of the impacted nostro accounts
number
required
The configured limit that was breached
number
required
The balance at the time of the alert

Liquidity Transfer Notification

Payload
integer
required
Liquidity transfer identifier
string
Identifier of the SEPA message carrying the transfer
string
required
Source nostro account IBAN
string
required
Destination nostro account IBAN
number
required
Transfer amount
string
required
Currency code (ISO 4217)
string
required
Transfer status. One of: CREATED, SENT_TO_CLEAR, ACCEPTED, REJECTED, COMPLETED
Set the Minutes between notifications value to control how often repeated alerts are sent for the same condition. This prevents notification floods when balances remain low.
Test your webhook URLs using the Test button next to each URL field in the settings page before saving.

API Reference

Get Nostro Balances

View current nostro account balances

Initiate Transfer

Manually transfer funds between nostro accounts

Transfer History

View past liquidity transfers

Account Statements

View nostro account statements
Last modified on July 10, 2026