--- updatedAt: 2026-08-03T20:03:01.000Z agentTools: projectIndex: https://docs.dlocal.com/llms.txt --- # Brazil Learn everything you need to know to make payouts in Brazil with dLocal. [block:html] { "html": "\n \n
\n\n \n
\n
\n
\"\"
\n

Market specifications

\n

\n Take a look of all the information you need to make a payout. \n

\n Country reference\n Document validations\n Mandatory paramenters\n\n
\n
\n \n \n \n
\n
\"\"
\n

Payment methods

\n

\n Find all the information about payment methods capabilities. \n

\n Bank transfers\n Pix transfers\n
\n
\n \n \n
\n
\n
\"\"
\n

Bank information

\n

\n Find all the bank account validations details you need to make a payout. \n

\n Bank account validations\n Bank codes\n
\n
\n \n " } [/block] *** # Market specifications Do you want to know more information about Brazil's market? Go to the [Brazil's economy and eCommerce market](https://dlocal.com/payment-processors-in-latin-america/brazil-payment-methods-processors-ecommerce-market-dlocal) article. ## Country reference | `country` code | `currency` code | `amount` decimals | `beneficiary.document.type` name | `beneficiary.document.id` format | | :------------: | :-------------: | :---------------: | :------------------------------: | :-------------------------------------------------: | | `BR` | `BRL` | 2 | CPF or CNPJ | Between 11 to 14 digits.
Full CPF validation. | ## Document validations | Validation | Name | Length | Type | Verification digit | Example | | :--------: | :--: | :----: | :-----: | :----------------: | :--------------------------------------: | | Document | CPF | 11 | numeric | last two digits | 450.539.758-09
45053975809 | | Document | CNPJ | 14 | numeric | last two digits | 55.694.732/0001-10
55694732000110 | ## Mandatory parameters ### Bank transfers | Bank transfer parameters | B2C | B2B | P2P | PSP | | :--------------------------------- | :-: | :-: | :-: | :-: | | `external_id` | Yes | Yes | Yes | Yes | | `payment_method_id` | Yes | Yes | Yes | Yes | | `flow_type` | Yes | Yes | Yes | Yes | | `purpose` | Yes | Yes | Yes | Yes | | `country` | Yes | Yes | Yes | Yes | | `amount` | Yes | Yes | Yes | Yes | | `currency` | Yes | Yes | Yes | Yes | | `beneficiary.first_name` | Yes | - | Yes | Yes | | `beneficiary.last_name` | Yes | - | Yes | Yes | | `beneficiary.business_name` | - | Yes | - | - | | `beneficiary.document.id` | Yes | Yes | Yes | Yes | | `beneficiary.address.street` | - | Yes | Yes | - | | `beneficiary.address.city` | - | Yes | Yes | - | | `beneficiary.bank_account.code` | Yes | Yes | Yes | Yes | | `beneficiary.bank_account.branch` | Yes | Yes | Yes | Yes | | `beneficiary.bank_account.account` | Yes | Yes | Yes | Yes | | `beneficiary.bank_account.type` | Yes | Yes | Yes | Yes | | `remitter.first_name` | - | Yes | Yes | - | | `remitter.last_name` | - | Yes | Yes | - | | `remitter.nationality` | - | Yes | Yes | - | | `remitter.document.id` | - | Yes | Yes | - | | `remitter.birth_info.date` | - | Yes | Yes | - | | `sub_merchant.business_name` | - | - | - | Yes | | `sub_merchant.registration_date` | - | - | - | Yes | | `sub_merchant.address.country` | - | - | - | Yes | | `sub_merchant.document.id` | - | - | - | Yes | ### Pix transfers | Pix transfers parameters | B2C | B2B | P2P | PSP | | :------------------------------- | :-: | :-: | :-: | :-: | | `external_id` | Yes | Yes | Yes | Yes | | `payment_method_id` | Yes | Yes | Yes | Yes | | `flow_type` | Yes | Yes | Yes | Yes | | `purpose` | Yes | Yes | Yes | Yes | | `amount` | Yes | Yes | Yes | Yes | | `currency` | Yes | Yes | Yes | Yes | | `country` | Yes | Yes | Yes | Yes | | `beneficiary.first_name` | Yes | - | Yes | Yes | | `beneficiary.last_name` | Yes | - | Yes | Yes | | `beneficiary.business_name` | - | Yes | - | - | | `beneficiary.document.id` | Yes | Yes | Yes | Yes | | `beneficiary.instant_payment.id` | Yes | Yes | Yes | Yes | | `remitter.first_name` | - | Yes | Yes | - | | `remitter.last_name` | - | Yes | Yes | - | | `remitter.document.id` | - | Yes | Yes | - | | `sub_merchant.business_name` | - | - | - | Yes | | `sub_merchant.registration_date` | - | - | - | Yes | | `sub_merchant.address.country` | - | - | - | Yes | | `sub_merchant.document.id` | - | - | - | Yes | *** # Payment methods Brazil supports payouts via Bank transfers and Pix transfers. Each method requires specific parameters and follows validation rules aligned with local compliance and banking standards. Use Pix for instant payments using a unique key (such as an email or CPF). Use Bank transfers using traditional account details when sending funds directly to a bank account. ## Bank transfers Bank transfers in Brazil require detailed account information, including bank code, branch, and account number. The format of these fields depends on the receiving bank, and strict validation rules apply. Refer to the [bank account validations](#bank-account-validations) and [bank codes](#bank-codes) sections for format specifications. ### Mandatory parameters All fields listed below are required for bank transfer payouts. For successful processing, ensure correct formatting and value types. | Mandatory parameter | Description | | :--------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------- | | `external_id` | Payout identification at the merchant's end. Maximum 100 characters. | | `payment_method_id` | Payment method. For bank transfer, use`BANK_TRANSFER`. | | `flow_type` | Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), or `P2P` (Person to Person). | | `purpose` | Payout purpose code. See [purpose codes reference](https://docs.dlocal.com/docs/purpose-codes-reference-v3). | | `country` | Country code. For Brazil, use `BR`. | | `currency` | Source currency of the FX operation. For Brazil, use`BRL` or `USD`. Payouts are always paid in local currency to the beneficiary. | | `amount` | Payout amount in `BRL`. Use up to 2 decimal places. | | `beneficiary.document.id` | Beneficiary's document ID or number. `CPF` or `CNPJ` number of the beneficiary. See the [document validations](#document-validations) section. | | `beneficiary.first_name` | Beneficiary's first name. Maximum 50 characters. | | `beneficiary.last_name` | Beneficiary's last name. Maximum 50 characters. | | `beneficiary.business_name` | Beneficiary's business name. Mandatory only for B2B. | | `remitter.document.id` | Remitter's document. Either `ID` or `PASS`. Maximum 45 characters. | | `beneficiary.address.street` | Beneficiary's address street. 200 characters. | | `beneficiary.address.city` | Beneficiary's city. Maximum 100 characters. | | `beneficiary.bank_account.code` | Beneficiary's bank account code. See the list of valid [bank codes](#bank-codes). | | `beneficiary.bank_account.branch` | Beneficiary's bank account branch. Format varies by bank. See the [branch validation](#bank-account-validations) section. | | `beneficiary.bank_account.account` | Beneficiary's bank account number. Format and prefixes vary by bank. See the [bank account validation](#bank-account-validations) section. | | `beneficiary.bank_account.type` | Beneficiary's bank account type. Account type:
`CHECKING`: Checking accounts
`SAVINGS`: Savings accounts | | `remitter.first_name` | Remitter's first name. Maximum 50 characters. Mandatory only for remittance (P2P). | | `remitter.last_name` | Remitter's last name. Maximum 50 characters. Mandatory only for remittance (P2P). | | `remitter.nationality` | Remitter's nationality. ISO 3166-1 alpha-2 code. | | `remitter.birth_info.date` | Remitter's birth date in ISO 8601 format (YYYY-MM-DD). Mandatory only for remittance (P2P). | | `sub_merchant.business_name` | Full name of the sub-merchant. Maximum 200 characters. Mandatory only for PSP. | | `sub_merchant.registration_date` | Sub-merchant's registration date in YYYY-MM-DD format. Mandatory only for PSP. | | `sub_merchant.address.country` | ISO 3166-1 alpha-2 country code of the sub-merchant. Mandatory only for PSP. | | `sub_merchant.document.id` | Sub-merchant's document (`CPF` or `CNPJ`). Maximum 45 characters. Mandatory only for PSP. | ### Example request ```json Bank transfers - B2C { "external_id": "BT_B2C_001", "payment_method_id": "BANK_TRANSFER", "flow_type": "B2C", "purpose": "OTHER_SERVICES", "country": "BR", "currency": "BRL", "amount": 1000.50, "beneficiary": { "first_name": "Maria", "last_name": "Silva", "document": { "id": "817.359.610-78" }, "bank_account": { "code": "341", "branch": "3537", "account": "46757-6", "type": "CHECKING" } } } ``` ```json Bank transfers - B2B { "external_id": "BT_B2B_002", "payment_method_id": "BANK_TRANSFER", "flow_type": "B2B", "purpose": "CAPITAL_CONTRIBUTION", "country": "BR", "currency": "BRL", "amount": 55000.75, "beneficiary": { "business_name": "Empresa Beneficiaria Ltda", "document": { "id": "19.943.360/0001-55" }, "address": { "street": "Rua das Flores, 100", "city": "São Paulo" }, "bank_account": { "code": "001", "branch": "4321", "account": "98765432", "type": "CHECKING" } }, "remitter": { "first_name": "Remitter", "last_name": "Company Lmtd.", "nationality": "US", "document": { "id": "86433567" }, "birth_info": { "date": "1995-01-15" } } } ``` ```json Bank transfers - P2P { "external_id": "BT_P2P_003", "payment_method_id": "BANK_TRANSFER", "flow_type": "P2P", "purpose": "REMITTANCES", "country": "BR", "currency": "BRL", "amount": 350.00, "beneficiary": { "first_name": "João", "last_name": "Santos", "document": { "id": "817.359.610-78" }, "address": { "street": "Avenida Brasil, 500", "city": "Rio de Janeiro" }, "bank_account": { "code": "104", "branch": "0019", "account": "123456", "type": "SAVINGS" } }, "remitter": { "first_name": "Martina", "last_name": "Flores", "nationality": "AR", "document": { "id": "20983747117" }, "birth_info": { "date": "1988-06-20" } } } ``` ## Pix transfers Pix is an instant payment system developed by the Central Bank of Brazil. It enables real-time transfers using a Pix key, which can be an email, phone number, CPF/CNPJ, or a randomly generated key. ### Mandatory parameters The table below outlines the required parameters for Pix transfers.
Mandatory parameter Description
`external_id` Payout identification at the merchant's end. Maximum 100 characters.
`payment_method_id` Payment method. For Pix transfers, use`INSTANT_PAYMENT`.
`flow_type` Payout flow type. Valid values: `B2C` (Business to Consumer), `B2B` (Business to Business), `P2P` (Person to Person) or`PSP` (Payment Service Provider).
`purpose` Payout purpose code. See [purpose codes reference](https://docs.dlocal.com/docs/purpose-codes-reference-v3).
`country` Country code. For Brazil, use `BR`.
`currency` Source currency of the FX operation. For Brazil, use`BRL` or `USD`. Payouts are always paid in local currency to the beneficiary.
`amount` Payout amount in `BRL`. Use up to 2 decimal places.
`beneficiary.first_name` Beneficiary's first name. Maximum 50 characters.
`beneficiary.last_name` Beneficiary's last name. Maximum 50 characters.
`beneficiary.business_name` Beneficiary's business name. Mandatory only for B2B.
`beneficiary.document.id` CPF or CNPJ number of the beneficiary. See the [document validations](#document-validations) section.
`beneficiary.instant_payment.id` Value of the Pix key. Required based on the type of PIX key shared: `EMAIL` Max. 100 chars.
`PHONE` Country code plus 11 digits. Ex: +5512345678901
`TAX_ID` See the [document validations](#document-validations) section.
`RANDOM` Randomly generated key provided by the bank.
`beneficiary.document.id` Document number of the sender. Maximum 45 characters.
`remitter.first_name` Remitter's first name. Maximum 100 characters.
`remitter.last_name` Remitter's last name. Maximum 100 characters
`remitter.document.id` Remitter's document. Either `ID` or `PASS`. Maximum 45 characters.
`sub_merchant.business_name` Full name of the sub-merchant. Maximum 200 characters. Mandatory only for PSP.
`sub_merchant.registration_date` Sub-merchant's registration date in YYYY-MM-DD format. Mandatory only for PSP.
`sub_merchant.address.country` ISO 3166-1 alpha-2 country code of the sub-merchant. Mandatory only for PSP.
`sub_merchant.document.id` Sub-merchant's document (`CPF` or `CNPJ`). Maximum 45 characters. Mandatory only for PSP.
### Example request ```json Pix transfers - B2C { "external_id": "PIX_B2C_001", "payment_method_id": "INSTANT_PAYMENT", "flow_type": "B2C", "purpose": "OTHER_SERVICES", "country": "BR", "currency": "BRL", "amount": 500.25, "beneficiary": { "first_name": "Juliana", "last_name": "Ferreira", "document": { "id": "400.186.900-41" }, "instant_payment": { "id": "400.186.900-41" } } } ``` ```json Pix transfers - B2B { "external_id": "PIX_B2B_002", "payment_method_id": "INSTANT_PAYMENT", "flow_type": "B2B", "purpose": "CAPITAL_CONTRIBUTION", "country": "BR", "currency": "BRL", "amount": 15000.00, "beneficiary": { "business_name": "Empresa Beneficiaria Ltda", "document": { "id": "19.943.360/0001-55" }, "instant_payment": { "id": "vendas@comercio.com.br" } }, "remitter": { "first_name": "Tech", "last_name": "Solutions Ltda", "document": { "id": "44333222000111" } } } ``` ```json Pix transfers - P2P { "external_id": "PIX_P2P_003", "payment_method_id": "INSTANT_PAYMENT", "flow_type": "P2P", "purpose": "AVAILABILITY", "country": "BR", "currency": "BRL", "amount": 85.90, "beneficiary": { "first_name": "Paulo", "last_name": "Machado", "document": { "id": "400.186.900-41" }, "instant_payment": { "id": "+5511987654321" } }, "remitter": { "first_name": "Helena", "last_name": "Delgado", "document": { "id": "11122233344" } } } ``` # Bank information Access the reference formats and accepted values required for processing bank payouts in Brazil.
## Bank account validations
Reference formats for common Brazilian banks. ### Reference * X --> Numeric character * D --> Alphanumeric character | Bank name | Bank Branch | Checkings Account | Savings Account | | :-------------------------- | :------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------- | :---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | Banco do Brasil S.A. | XXXX, XXXXD or XXXX-D | XXXXX, XXXXXX, XXXXXXXX or XXXXXXXX-X | XXXXX, XXXXXX, XXXXXXXXX or XXXXXXXXX-X
Prefixes: 51, 52, 61, 96 or 97 | | Banco Santander Brasil S.A. | XXXX | XXXXXXXX-X
Prefixes: 01, 02, 11, 13, 29 and 77 | XXXXXXXX-X
Prefixes: 60 | | Caixa CEF | XXXX, XXXXX or XXXX-X | XXX.XXXXXXXX-X or any combination with or without `.` or `-` characters and prefix or verification code.
Prefixes: 001, 010, 003 or 023 | XXXX.XXXXXXXX-X
Prefixes: 0000

XXX.XXXXXXXXX-X
Prefixe: 000

XXX.XXXXXXXX-X
Prefixes: 013, 022

All the combinations with or without `.` or `-` characters. | | Banco Bradesco S.A. | XXXX, XXXXX or XXXX-X | XXXXX, XXXXXXX or XXXXXXX-X | XXXXX, XXXXXXX or XXXXXXX-X | | Itau Unibanco S.A. | XXXX | XXXXX-X or XXXXXXX-X | XXXXX-X or XXXXXXX-X | | HSBC Bank Brasil S.A. | XXXX, XXXXD, XXXXDD, XXXX-D or XXXX-DD | XXXXX-XX | XXXXX-XX | | Other banks | XXXX, XXXXD, XXXXDD, XXXX-D or XXXX-DD | - | - | | Pix account | No format validation | No format validation | |
***
## Bank codes These are the values the `beneficiary.bank_account.code` parameter can take in Brazil. The following bank codes will only accept payments in case the provided `beneficiary.document.id` is not a CPF: 18, 66, 78, 139, 241, 477, 739, 745. | Bank Name | Bank Code | | :---------------------------------------------------------------- | :-------: | | Acesso Soluções Pagamento S.A. | 332 | | Banco A.J. Renner S.A. | 654 | | Banco ABC Brasil S.A. | 246 | | Banco ABN Amro S.A. | 075 | | Banco Agiplan S.A. | 121 | | Banco Alfa S.A. | 025 | | Banco AndBank (Brasil) S.A. | 065 | | Banco Arbi S.A. | 213 | | Banco B3 S.A. | 096 | | Banco Bandepe S.A. | 024 | | Banco Bari de Investimentos e Financiamentos S.A. | 330 | | Banco BMG S.A. | 318 | | Banco BNP Paribas Brasil S.A. | 752 | | Banco Bocom BBM S.A. | 107 | | Banco Bonsucesso S.A. | 218 | | Banco Bradesco BBI S.A. | 036 | | Banco Bradesco BERJ S.A. | 122 | | Banco Bradesco Financiamentos S.A. | 394 | | Banco Bradesco S.A. | 237 | | Banco BTG Pactual S.A. | 208 | | Banco C6 S.A. | 336 | | Banco Caixa Geral - Brasil S.A. | 473 | | Banco Capital S.A. | 412 | | Banco Cargill S.A. | 040 | | Banco Cédula S.A. | 266 | | Banco Cetelem S.A. | 739 | | Banco Cifra S.A. | 233 | | Banco Citibank | 745 | | Banco Clássico S.A. | 241 | | Banco Cooperativo do Brasil S.A. - Bancoob | 756 | | Banco Cooperativo Sicredi S.A. | 748 | | Banco Crédit Agricole Brasil S.A. | 222 | | Banco Credit Suisse (Brasil) S.A. | 505 | | Banco Crefisa S.A. | 069 | | Banco da Amazônia S.A. | 003 | | Banco da China Brasil S.A. | 083 | | Banco Daycoval S.A. | 707 | | Banco de Brasília S.A. - BRB | 070 | | Banco de la Nación Argentina | 300 | | Banco Digio S.A. | 335 | | Banco do Brasil S.A. | 001 | | Banco do Estado de Sergipe S.A. - Banese | 047 | | Banco do Estado do Pará S.A. - Banpará | 037 | | Banco do Estado do Rio Grande do Sul S.A. - Banrisul | 041 | | Banco do Nordeste do Brasil S.A. | 004 | | Banco Fator S.A. | 265 | | Banco Fibra S.A. | 224 | | Banco Ficsa S.A. | 626 | | Banco Finaxis S.A. | 094 | | Banco Genial | 278 | | Banco Guanabara S.A. | 612 | | Banco Inbursa S.A. | 012 | | Banco Industrial do Brasil S.A. | 604 | | Banco Indusval S.A. | 653 | | Banco Inter | 077 | | Banco Investcred Unibanco S.A. | 249 | | Banco Itaú BBA S.A. | 184 | | Banco Itaú Consignado S.A. | 029 | | Banco J. Safra S.A. | 074 | | Banco J.P. Morgan S.A. | 376 | | Banco John Deere S.A. | 217 | | Banco KDB do Brasil S.A. | 076 | | Banco KEB Hana do Brasil S.A. | 757 | | Banco Luso Brasileiro S.A. | 600 | | Banco Máxima S.A. | 243 | | Banco Mercantil do Brasil S.A. | 389 | | Banco Mizuho do Brasil S.A. | 370 | | Banco Modal S.A. | 746 | | Banco Morgan Stanley S.A. | 066 | | Banco MUFG Brasil S.A. | 456 | | Banco Nacional de Desenvolvimento Econômico e Social | 007 | | Banco Olé Bonsucesso Consignado S.A. | 169 | | Banco Original | 212 | | Banco Original do Agronegócio S.A. | 079 | | Banco Ourinvest S.A. | 712 | | Banco Panamericano S.A. | 623 | | Banco Paulista S.A. | 611 | | Banco Pine S.A. | 643 | | Banco Rabobank International Brasil S.A. | 747 | | Banco Rendimento S.A. | 633 | | Banco Ribeirão Preto S.A. | 741 | | Banco Rodobens S.A. | 120 | | Banco Safra S.A. | 422 | | Banco Santander Brasil S.A. | 033 | | Banco Semear S.A. | 743 | | Banco Sistema S.A. | 754 | | Banco Smartbank S.A. | 630 | | Banco Société Générale Brasil S.A. | 366 | | Banco Sofisa | 637 | | Banco Sumitomo Mitsui Brasileiro S.A. | 464 | | Banco Topázio S.A. | 082 | | Banco Triângulo S.A. | 634 | | Banco Tricury S.A. | 018 | | Banco Votorantim S.A. (Banco Neon) | 655 | | Banco VR S.A. | 610 | | Banco Western Union do Brasil S.A. | 119 | | Banco Woori Bank do Brasil S.A. | 124 | | Banco XP S.A. | 348 | | BancoSeguro S.A. | 081 | | Banestes S.A. Banco do Estado do Espírito Santo | 021 | | Bank of America Merrill Lynch Banco Múltiplo S.A. | 755 | | BCV - Banco de Crédito e Varejo S.A. | 250 | | Bexs Banco de Câmbio S.A. | 144 | | Bexs Corretora de Câmbio S.A. | 253 | | BNY Mellon Banco S.A. | 017 | | BPP Instituição de Pagamento S.A. | 301 | | BR Partners Banco de Investimento S.A. | 126 | | Caixa Econômica Federal - CEF | 104 | | China Construction Bank (Brasil) Banco Múltiplo S.A. | 320 | | Citibank N.A. | 477 | | Commerzbank Brasil S.A. - Banco Múltiplo | 163 | | Confederação Nacional das Cooperativas Centrais Unicreds | 136 | | Cooperativa Central de Crédito Urbano - Cecred | 085 | | Cora SCD S.A. | 403 | | Credicoamo Crédito Rural Cooperativa | 010 | | Credit Suisse Hedging-Griffo Corretora de Valores S.A. | 011 | | Cresol Confederação | 133 | | Deutsche Bank S.A. - Banco Alemão | 487 | | Goldman Sachs do Brasil Banco Múltiplo S.A. | 064 | | Haitong Banco de Investimento do Brasil S.A. | 078 | | Hipercard Banco Múltiplo S.A. | 062 | | HSBC Brasil S.A. - Banco de Investimento | 269 | | ICBC do Brasil Banco Múltiplo S.A. | 132 | | ING Bank N.V. | 492 | | Intesa Sanpaolo Brasil S.A. - Banco Múltiplo | 139 | | Itaú Unibanco Holding S.A. | 652 | | Itaú Unibanco S.A. | 341 | | JPMorgan Chase Bank National Association | 488 | | Kirton Bank S.A. - Banco Múltiplo | 399 | | Mercadopago.com Representações Ltda. | 323 | | Moneycorp Banco de Câmbio S.A. | 259 | | MS Bank S.A. Banco de Câmbio | 128 | | Novo Banco Continental S.A. - Banco Múltiplo | 753 | | Nu Pagamentos (Nubank) | 260 | | Omni Banco S.A. | 613 | | PagSeguro Internet S.A. | 290 | | Paraná Banco S.A. | 254 | | Plural S.A. Banco Múltiplo | 125 | | Scotiabank Brasil S.A. Banco Múltiplo | 751 | | State Street Brasil S.A. – Banco Comercial | 014 | | Stone Pagamentos S.A. | 197 | | Travelex Banco de Câmbio S.A. | 095 | | UBS Brasil Banco de Investimento S.A. | 129 | | UBS Brasil Corretora de Câmbio Títulos e Valores Mobiliários S.A. | 015 | | Unicred Norte do Paraná | 084 |