Virtual Accounts

Account numbers for receiving bank transfers

A real account number (IBAN) in your name or a merchant's. Payers send a normal bank transfer to it.

Create one

curl -X POST 'https://sandbox-api.transfi.com/v3/iban' \
  -H 'Authorization: Basic YOUR_BASE64_CREDENTIALS' \
  -H 'mid: YOUR_MID' \
  -H 'Content-Type: application/json' \
  -d '{ "currency": "EUR" }'

Add "customer": { "userId": "UX-..." } to create it for a merchant. Deposits are then attributed to them.

→ Create Virtual IBAN · List Virtual IBANs · Get IBAN Balance · Link IBAN Orders

Why a deposit is held

Before the money becomes available, all four must be true: a matching order exists · the sender is identified · compliance checks passed · the sender's verification is complete. If a deposit is held, it's almost always the first two.

📘
A deposit with no order can be linked to a customer with Link IBAN Orders. Checks then run and it's released if they pass.

How to collect with one: Virtual Account

Updated 35 minutes ago

Did this page help you?