Skip to main content

Payouts via online banking in Brazil

To make account credits using online banking in Brazil, a request to the Tranzzo API must contain the following parameters:

ParameterTypeRequiredDescription
pos_idUUID✅Merchant's identifier (POS_ID)
modeMODE✅direct
methodMETHOD✅Payment method (credit)
amountNumber✅Transaction amount. Must be a positive number. The number of decimal digits must be less than or equal to 2 (e.g., 100.00, 250, 50.50)
currencyCURRENCY✅Transaction currency (ISO_4217)
order_3ds_bypassString✅3-D Secure flow option
order_idString✅Unique identifier of order
descriptionString✅Payment description
paywayString✅banking
server_urlURLWebhook notification will be sent to this URL
result_urlURLCustomer will be redirected to this URL after payment.
customer_fnameString✅recipient’s first name
customer_lnameString✅recipient’s last name
properties.document_idString✅recipient’s document ID
properties.document_typeStringrecipient’s document type
properties.bank_account_typeString✅recipient’s account type
properties.bank_accountString✅recipient’s account number
properties.bank_account_digitString✅bank account digit
properties.bank_account_codeString✅bank account code
properties.branch_codeString✅bank regional code

The value of the payway parameter must be banking.

Validation: the properties.document_type parameter is optional for transaction creation (it can be used for informational purposes for you).

Request example:

{
"pos_id": "'$POS_ID'",
"mode": "direct",
"method": "credit",
"amount": 1,
"currency": "BRL",
"order_3ds_bypass": "supported",
"order_id": "'$ORDER_ID'",
"description": "Test description",
"payway": "banking",
"customer_lname": "Doe",
"customer_fname": "John",
"properties": {
"document_id": "0000000000",
"document_type": "CPF",
"bank_account_type": "CHECKING",
"bank_account": "12345678",
"bank_account_digit":"2",
"bank_account_code": "260",
"branch_code": "0001"
},
"server_url": "https://callback.blackhole.com/callback",
"result_url": "https://example.com/result"
}