Country and Currency

View as Markdown

This reference covers bank payment methods (pay-to-bank and pay-by-bank). Card payment methods use separate collection flows; markets and currencies for cards are not listed here.

Bank accounts are identified by country_code, currency_code, and market-specific fields. Use the table below for expected combinations, request field shapes, and typical verification behavior. Your integration may enable a subset of rows today; additional markets are added over time.

When you add a bank payment method, send country_code, currency_code, routing_number_type, account_number, and routing_number consistent with the row for that currency. Mismatched combinations (for example a US country code with an IBAN-shaped account, or Great Britain with ABA routing) return 400 validation errors.

For United States bank accounts, country_code and currency_code often default to US and USD when omitted; routing_number_type defaults to aba.

Bank payment methods by currency

CurrencyMarketcountry_codecurrency_coderouting_number_typeaccount_numberrouting_numberVerificationVerification timing
USDUnited StatesUSUSDabaDomestic account number (digits only; not IBAN-shaped)9-digit ABA routing numberUS ABA account verificationOften verified or failed on create
GBPGreat BritainGBGBPbicValid GB IBAN (check digits; GB prefix)BIC / SWIFT (8 or 11 characters)Global account verification (Liink Confirm)May be pending until verification completes
EUREurozone (for example DE, FR, ES, IT, NL)Supported eurozone codeEURbicIBAN for the selected country_code (prefix must match)BIC / SWIFT (8 or 11 characters)Global account verificationMay be pending until verification completes
INRIndiaININRifscDomestic bank account number11-character IFSC (for example HDFC0001234)Global account verificationMay be pending until verification completes

All request fields are strings. account_number and routing_number are required; routing_number_type, country_code, and currency_code are optional but must match the row when provided.

Response fields

FieldTypeDescription
verification_statusStringpending, verified, or failed — see Payment Methods API for the verification status lifecycle
country_codeStringISO 3166-1 alpha-2 country code of the bank account
currency_codeStringISO 4217 currency code of the account

When verification is asynchronous, poll payment method list or detail endpoints, or rely on webhooks, until verification_status is verified or failed.