Bank deposit
| Field | Type | Description |
|---|---|---|
type | string | "BANK_DEPOSIT" |
countryCode | string | ISO alpha-3 of the destination bank |
accountNumber | string | Account number, IBAN, or alias — format enforced per country |
accountNumberType | string | Selects the rail on corridors that offer more than one — see below |
bankCode | string | Bank, sort code, IFSC, CNAPS, or branch identifier |
routingNumber | string | Secondary routing identifier (Brazil agência, Sri Lanka branch code) |
accountType | string | "CHECKING" or "SAVINGS" |
accountNumberType — alias rails
Some countries let one BANK_DEPOSIT carry either a conventional account number or an alias. The value changes which other fields are required.
accountNumberType is never required in itself — no schema marks it required, and none declares a default. It is what selects the rail: send it to take the alias rail, omit it and the corridor falls to its conventional one, exactly as if you had sent BBAN.
| Country | Values | Effect |
|---|---|---|
Czech Republic (CZE) | BBAN, IBAN | BBAN takes the 8–22-character local account plus a 4-digit bankCode; IBAN takes the 24-character CZ… alone |
Denmark (DNK) | BBAN, IBAN | BBAN takes the 4–10-digit account plus the 4-digit registreringsnummer in routingNumber; IBAN takes the 18-character DK… alone |
Hungary (HUN) | BBAN, IBAN | BBAN takes the 16–24-character account alone; IBAN takes the 28-character HU… |
India (IND) | BBAN, UPI | UPI puts a Virtual Payment Address (user@psp) in accountNumber and drops bankCode/accountType; BBAN requires all three |
Mexico (MEX) | BBAN, DIMO | DIMO sends to a 10-digit phone number and requires bankCode; BBAN takes an 18-digit CLABE alone |
Norway (NOR) | BBAN, IBAN | BBAN takes the 11-digit account alone; IBAN takes the 15-character NO… |
Poland (POL) | BBAN, IBAN | BBAN takes the 26-character NRB plus the 8-digit bank/branch code in routingNumber; IBAN takes the 28-character PL… alone |
Sweden (SWE) | BBAN, IBAN | BBAN takes the local account plus the clearing code in bankCode; IBAN takes the 24-character SE… alone |
United Kingdom (GBR) | BBAN, IBAN | BBAN requires the 8-digit account plus a sort code in bankCode |
SEPA countries take an IBAN in
accountNumberand have noaccountNumberType— the IBAN's own country prefix is the rail.
What's Next
- Country coverage — Which corridors offer this method
- Examples — Complete request bodies