Skip to main content

Online banking in Brazil

To enable online banking in Brazil, you need to use direct integration. When creating a payment, send a request with the following parameters:

ParameterTypeRequiredDescription
pos_idUUIDMerchant's identifier (POS_ID)
modeMODEdirect
methodMETHODPayment method (purchase)
amountNumberTransaction amount
currencyCURRENCYTransaction currency (ISO_4217)
order_3ds_bypassString3-D Secure flow option
order_idStringUnique identifier of order
descriptionStringPayment description
paywayStringbanking
server_urlURLWebhook notification will be sent to this URL
result_urlURLCustomer will be redirected to this URL after payment.
customer_fnameStringpayer’s first name
customer_lnameStringpayer’s last name
customer_emailStringpayer’s email address
customer_ipStringpayer’s IP
properties.trustedBooleanwhether the trusted payer
properties.instrument_typeStringinstrument type (online_banking)
properties.instrument_methodStringinstrument method alias
properties.bank_codeStringpayer’s regional bank code
properties.branch_codeStringpayer’s bank branch code
properties.bank_account_typeStringpayer’s bank account type
properties.account_numberStringpayer’s bank account number
properties.document_idStringpayer’s document number
properties.document_typeStringpayer’s document type

Request example:

{
"pos_id": "00000000-0000-0000-0000-000000000000",
"mode": "direct",
"amount": 1,
"method": "purchase",
"currency": "BRL",
"payway": "banking",
"customer_lname": "Doe",
"customer_fname": "John",
"order_3ds_bypass": "supported",
"customer_email": "[email protected]",
"properties": {
"instrument_type": "online_banking",
"instrument_method": "BANK_BRAZIL",
"bank_code": "143",
"branch_code": "0001",
"bank_account_type": "S",
"account_number": "00112233445566",
"document_id": "00000000001",
"document_type": "CPF"
},
"description": " Description",
"order_id": "1234567890",
"server_url": "http://callback-stub:9000/consume",
"result_url": "https://google.com"
}