← Back to Account Payouts docs
← Back to Parties docs

Brazil

Domestic Payment (same-day)

Overview

Available	Yes
`targetCurrency`	Brazilian Real (BRL)
`countryCode`	BR
Earliest Beneficiary Credit	same-day
Cut-Off Time (UK Time)	13:20
Decimal Places	2
Minimum `targetAmount`	0.01
Maximum `targetAmount`	9999999.99

Submission data

API field name	Required?	Field length	Description
`beneficiaryBankDetails.accountType`	✅	N/A	Type of account. Available values: `checking` `savings`
`beneficiaryBankDetails.accountNumber`	✅	Max 12	Account number of the beneficiary. Important Please note, each bank and account type may have different format of the bank branch code and bank account number. See below for detailed validations.
`beneficiaryBankDetails.branchCode`	✅	Max 6	The Bank Branch Number (Agencia) is the local branch clearing code for the beneficiary bank. This can be between 3 and 7 digits, and is normally comprised of a 3 digit bank code and 4 digit branch code.
`beneficiaryBankDetails.bankName`	✅	Max 35	Name of the beneficiary bank.
`parties.partyType`	✅	N/A	Type of the party. Must be: `beneficiary`
`parties.personalDetails.type`	✅	N/A	Entity description code for the party. Available values: `company` `person` `soleTrader` `institution` `government`
`parties.personalDetails.title`	Conditional	N/A	Title code for the Individual. Available values: `ms` `mrs` `mr` `dr` `mx` `misc` Condition Mandatory if `parties.personalDetails.type` is: `person`
`parties.personalDetails.firstName`	Conditional	Max 50	Beneficiary first name. Full name should be provided (no initials). Condition Mandatory if `parties.personalDetails.type` is: `person`
`parties.personalDetails.middleName`	❌	Max 50	Beneficiary middle name.
`parties.personalDetails.lastName`	Conditional	Max 50	Beneficiary last name. Condition Mandatory if `parties.personalDetails.type` is: `person`
`parties.personalDetails.companyName`	Conditional	Max 140	Full name of the organization. Important Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager. Condition Mandatory if `parties.personalDetails.type` is: `company` `institution` `government` `other`
`parties.personalDetails.dateOfBirth`	❌	10	Beneficiary's date of birth in YYYY-MM-DD format.
`parties.personalDetails.dateOfIncorporation`	❌	10	A `company`s date of incorporation in YYYY-MM-DD format.
`parties.identityDocuments.type`	✅	N/A	Beneficiary's identity type. Available values: `taxId` (CPF - tax ID for individuals) `taxRegistrationCode` (CNPJ - tax ID for corporations)
`parties.identityDocuments.number`	✅	11 or 14	Beneficiary's identity number. CPF (a 11 digit tax ID for individuals) / CNPJ 14 digit tax ID for corporations)
`parties.identityDocuments.issuingCountry`	✅	2	Beneficiary's country code of their identification document. Enter the 2 character ISO 3166-1 standard country code in your API request.
`parties.address.address1`	❌	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street.
`parties.address.address2`	❌	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
`parties.address.city`	❌	Max 35	Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
`parties.address.postalCode`	❌	Max 10	Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
`parties.address.countryCode`	❌	2	Beneficiary's country code of their residential (if payee is an individual) or registered (if payee is a company) address. Enter the 2 character ISO 3166-1 standard country code in your API request.

Important

Additional data is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).

Important

Whilst Worldpay can make a local payment to Brazil in BRL, we are not able to fund these payments in BRL, so FX fees will be applied when making local payments to Brazil.

Important

Additional supporting documentation may be required from the beneficiary stating the reason for the payment at their local bank to receive credit into the account.

Brazil Bank Account and Branch Code Validations

Reference X - Numeric character D - Alphanumeric character

Bank Name	`beneficiaryBankDetails.branchCode`	`beneficiaryBankDetails.accountNumber` (Checking)	`beneficiaryBankDetails.accountNumber` (Savings)
Banco do Brasil S.A.	XXXX, XXXXD or XXXX-D	XXXXXXXX or XXXXXXXX-X	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 Prefixes: 000 XXX.XXXXXXXX-X Prefixes: 013, 022 All the combinations with or without. or - characters.
Banco Bradesco S.A.	XXXX, XXXXX or XXXX-X	XXXXXXX or XXXXXXX-X	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	-	-

International WIRE

Overview

Available	Yes
`targetCurrency`	Available WIRE currencies
`countryCode`	BR
Earliest Beneficiary Credit	The estimated delivery time will vary by country and currency.
Cut-Off Time (UK Time)	Currency specific
Decimal Places	2
Minimum `targetAmount`	0.01
Maximum `targetAmount`	9999999.99

Submission data

API field name	Required?	Field length	Description
`beneficiaryBankDetails.accountNumber`	✅	35	Account number of the beneficiary.
`beneficiaryBankDetails.swiftBic`	✅	8 or 11	The SWIFT BIC is the Bank Identification Code of the beneficiary bank.
`beneficiaryBankDetails.bankName`	✅	Max 35	Name of the beneficiary bank.
`parties.partyType`	✅	N/A	Type of the party. Must be: `beneficiary`
`parties.personalDetails.type`	✅	N/A	Entity description code for the party. Available values: `company` `person` `soleTrader` `institution` `government` `institution` `government` `other`
`parties.personalDetails.title`	Conditional	N/A	Title code for the Individual. Available values: `ms` `mrs` `mr` `dr` `mx` `misc` Condition Mandatory if `parties.personalDetails.type` is: `person`
`parties.personalDetails.firstName`	Conditional	Max 50	Beneficiary first name. Full name should be provided (no initials). Condition Mandatory if `parties.personalDetails.type` is: `person`
`parties.personalDetails.middleName`	❌	Max 50	Beneficiary middle name.
`parties.personalDetails.lastName`	Conditional	Max 50	Beneficiary last name. Condition Mandatory if `parties.personalDetails.type` is: `person`
`parties.personalDetails.companyName`	Conditional	Max 140	Full name of the organization. Important Failure to provide the full name could result in delays and potential rejection of your payment. This must consist of 2 words, separated by a space. To whitelist any other naming format please contact your Relationship Manager. Condition Mandatory if `parties.personalDetails.type` is: `company` `institution` `government` `other`
`parties.personalDetails.dateOfBirth`	❌	10	Beneficiary's date of birth in YYYY-MM-DD format.
`parties.personalDetails.dateOfIncorporation`	❌	10	A `company`s date of incorporation in YYYY-MM-DD format.
`parties.address.address1`	✅	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) house number/name and street e.g. 1 Main Street.
`parties.address.address2`	❌	Max 35	Beneficiary's residential (if payee is an individual) or registered (if payee is a company) address e.g. apartment no., unit, studio.
`parties.address.city`	✅	Max 35	Beneficiary's city or town of their residential (if payee is an individual) or registered (if payee is a company) address.
`parties.address.postalCode`	❌	Max 10	Beneficiary's postal code or zip code of their residential (if payee is an individual) or registered (if payee is a company) address.
`parties.address.countryCode`	Conditional	2	Beneficiary's country code of their residential (if payee is an individual) or registered (if payee is a company) address. Condition Mandatory if any of the optional Beneficiary address details are provided. Enter the 2 character ISO 3166-1 standard country code in your API request.

Important

Additional data is required if the requestor of the payout is a Payment Service Provider (PSP) or Money Service Business (MSB).

Brazil

Domestic Payment (same-day)

Overview

Submission data

Brazil Bank Account and Branch Code Validations

International WIRE

Overview

Submission data

Do you like our page?