Skip to main content
POST
Initiate liquidity transfer

Overview

This endpoint initiates a liquidity transfer. The optional transferType field selects what happens; it defaults to INTERNAL: paymentScheme (SEPACT or SEPAINST) is required for SAFEGUARDING and must be absent for INTERNAL. purpose (optional, up to 140 characters) sets the purpose of the SAFEGUARDING payment and defaults to Transfer to safeguarding account; INTERNAL ignores it. Transfers across clearing systems are not supported. The Idempotency-Key header is required; repeating a request with the same key returns the original transfer. Requires the transaction-manager role or a read-write API client.

Headers

Idempotency-Key
string
required

Body

application/json

Basic liquidity transfer request example

amount
integer
required

Amount in minor currency units

creditorAccount
string
required

Creditor (Recipient) Account IBAN. INTERNAL: the destination settlement account. SAFEGUARDING: a registered safeguarding account

Required string length: 1 - 34
currency
string
required

Currency units

Required string length: 1 - 3
debtorAccount
string
required

Debtor (Sender) Account IBAN. INTERNAL: the source settlement account for CENTROlink, the registered operational account for EKS. SAFEGUARDING: a registered operational account

Required string length: 1 - 34
paymentScheme
enum<string> | null

SEPACT or SEPAINST. Decides which settlement account is debited and how fast the payment settles. Required for SAFEGUARDING, must be absent for INTERNAL

Available options:
SEPACT,
SEPAINST
purpose
string | null

Purpose of the safeguarding payment. Defaults to "Transfer to safeguarding account" when absent or blank. Ignored for INTERNAL

Maximum string length: 140
Example:

"Transfer to safeguarding account"

transferType
enum<string>
default:INTERNAL

INTERNAL (default) moves liquidity between settlement accounts of the same BIC; SAFEGUARDING pays funds out of the settlement account of the selected scheme to a registered safeguarding account, as a SEPA payment

Available options:
INTERNAL,
SAFEGUARDING

Response

Liquidity transfer initiated

amount
integer
required
createdAt
string<date-time>
required
creditorAccount
string
required
currency
string
required
debtorAccount
string
required
endToEndId
string
required
id
integer<int64>
required
sepaMessageId
string
required
settlementDate
string<date>
required
status
enum<string>
required
Available options:
CREATED,
SENT_TO_CLEAR,
ACCEPTED,
REJECTED,
COMPLETED
transferType
enum<string>
required
Available options:
INTERNAL,
SAFEGUARDING
updatedAt
string<date-time>
required
Last modified on October 8, 2026