Depósito bancário
| Campo | Tipo | Descrição |
|---|---|---|
type | string | "BANK_DEPOSIT" |
countryCode | string | ISO alpha-3 do banco de destino |
accountNumber | string | Número da conta, IBAN ou alias — formato validado por país |
accountNumberType | string | Seleciona o trilho nos corredores que oferecem mais de um — veja abaixo |
bankCode | string | Identificador de banco, sort code, IFSC, CNAPS ou agência |
routingNumber | string | Identificador de roteamento secundário (agência no Brasil, código de agência no Sri Lanka) |
accountType | string | "CHECKING" ou "SAVINGS" |
accountNumberType — trilhos de alias
Alguns países permitem que um mesmo BANK_DEPOSIT carregue tanto um número de conta convencional quanto um alias. O valor muda quais outros campos são obrigatórios.
accountNumberType nunca é obrigatório em si — nenhum schema o marca como obrigatório nem declara um valor padrão. É ele que seleciona o trilho: envie-o para usar o trilho de alias; omita-o e o corredor cai no trilho convencional, exatamente como se você tivesse enviado BBAN.
| País | Valores | Efeito |
|---|---|---|
Dinamarca (DNK) | BBAN, IBAN | BBAN aceita a conta de 4 a 10 dígitos mais o registreringsnummer de 4 dígitos em routingNumber; IBAN aceita apenas o DK… de 18 caracteres |
Hungria (HUN) | BBAN, IBAN | BBAN aceita apenas a conta de 16 a 24 caracteres; IBAN aceita o HU… de 28 caracteres |
Índia (IND) | BBAN, UPI | UPI coloca um Virtual Payment Address (user@psp) em accountNumber e dispensa bankCode/accountType; BBAN exige os três |
México (MEX) | BBAN, DIMO | DIMO envia para um telefone de 10 dígitos e exige bankCode; BBAN aceita apenas a CLABE de 18 dígitos |
Noruega (NOR) | BBAN, IBAN | BBAN aceita apenas a conta de 11 dígitos; IBAN aceita o NO… de 15 caracteres |
Polônia (POL) | BBAN, IBAN | BBAN aceita o NRB de 26 caracteres mais o código de banco/agência de 8 dígitos em routingNumber; IBAN aceita apenas o PL… de 28 caracteres |
Reino Unido (GBR) | BBAN, IBAN | BBAN exige a conta de 8 dígitos mais o sort code em bankCode |
República Tcheca (CZE) | BBAN, IBAN | BBAN aceita a conta local de 8 a 22 caracteres mais um bankCode de 4 dígitos; IBAN aceita apenas o CZ… de 24 caracteres |
Suécia (SWE) | BBAN, IBAN | BBAN aceita a conta local mais o clearing code em bankCode; IBAN aceita apenas o SE… de 24 caracteres |
Os países SEPA aceitam um IBAN em
accountNumbere não têmaccountNumberType— o próprio prefixo de país do IBAN é o trilho.
Próximos passos
- Cobertura por país — Quais corredores oferecem este método
- Exemplos — Corpos de requisição completos