Bank Account callback#

Bank accounts created within the SEPA Secure flow may not be immediately active. This delay most commonly affects USD accounts. To keep you informed, a callback (webhook) is sent once the account becomes active and ready to receive fiat deposits.

Set up the bank account details callback endpoint#

To accept the bank account details you should configure the endpoint on your side and provide it during the integration setup.

Callback endpoint#

POST https://your-callback-url-here.com/handle-bank-accounts

A payload will be delivered to you on every bank account activation.

Callback payload#

Name	Type	Description
callbackType	"bank_account"	The type of callback
accountNumber	String \| null	The Bank account number
bic	String \| null	The Bank Identifier Code
country	String	The Bank account country
currency	String	The Bank account currency
customerId	String	The unique customer ID in the merchant system
hash	String	The base64-encoded hash is generated using the sha512 algorithm and includes the customer ID, currency, and secret key. The string that will be hashed: `{customer ID}.{currency}.{secretKey}`
iban	String \| null	The virtual International Bank Account Number
sortCode	String \| null	The six-digit number used in the UK and Ireland to identify the specific bank and branch. Used for GBP
status	String	The status of the Bank account. "PENDING" or "ACTIVE"

Payload example#

The callback you get after successful account creation might look like this:

{
  "callbackType": "bank_account",
  "accountNumber": "00386255",
  "bic": "CFTEMTM1",
  "country": "GB",
  "currency": "USD",
  "customerId": "demo_customer_id",
  "hash": "[HASH]",
  "iban": "MT36CFTE28004000000000003225049",
  "sortCode": "040679",
  "status": "ACTIVE"
}

The callback data above is provided for demonstration purposes only.

Response and data handling#

You may handle the payload information as needed. You do not need to send anything back other than a success status to confirm that the callback has been received and processed on your side.