This page presents all information related to the Banco do Brasil connection using PIX as the payment method. Use the following buttons to navigate to the desired section.

General Information

Refunds

Voids

Testing Guidelines

Integration Configuration

Connecting with Yuno

Mandatory fields when integrating via Yuno:

document_number

General information

Countries:

Brazil

Currencies:

BRL

Payment methods:

Bank Transfer

Minimum amount:

0,01 BRL

Type of integration:

B2B

Purchase TRX:

When a purchase is made, we receive a string in the response called PIX Copia e Cola, which is used to generate the QR Code for the payer.

Support for recurrency:

Webhooks:

Yes

Refunds

Refund support:

Yes

Partial refunds:

Yes

Multiple refund:

Yes

Voids

Void support:

Installments

Installments sent directly in request:

Chargebacks

Notifications of chargebacks:

Testing guidelines for sandbox environment

Necessary fields for testing:

Developer App Key
CNPJ
Client ID
Client Secret
Número de Convênio (3128557 can be used for testing)

Limitations/Specification for testing:

To simulate the payment of a boleto, Banco do Brasil provides an endpoint in the sandbox environment, available in the Postman collection under Simular pagoBoleto. The only required data for this endpoint is the linhaDigitavel, which is included in the response to the Purchase endpoint and corresponds to the numerical representation of the barcode.

Integration configuration

Credentials and steps to obtain them:

Request access to Banco do Brasil's dashboard from their support team.
After gaining access, click on Criar nova aplicação and configure your application as needed.
After creating and configuring your application, go to Credenciais in the left menu. There, you'll find your Developer Application Key, Client ID, and Client Secret.

Dashboard configuration:

Log in to dashboard.y.uno.
Click Connections and then select Banco do Brasil.
Click Connect.
Introduce Developer App Key, CNPJ, Client ID and Client Secret.
Click Connect

Production Environment

Specific procedure for a merchant to go live:

In both SBX and PROD environments, create an application in the Banco do Brasil dashboard. The application configuration determines which APIs are available and other settings tied to its credentials. After testing in SBX, follow this process to deploy it to PROD:

Select the application you want to send to production.
On the menu located to the left-hand size, select the Produção option.
Fill in the CNPJ of the company you want to link the application to and click on Pesquisar CNPJ. The system will display the identification of the selected company. Check that the information is correct and click on Próximo.
Review your application data and click on Solicitar Produção.
Next, an Adhesion Form will appear. The representative must read and sign it if they agree with the terms. Once signed, the production credentials will be activated in the Credenciais area and will be visible to the Developer and the application's team members.