This endpoint allows users to obtain the associated bank and account details from the DICT PIX key.
DICT Key Types and Requirements
The DICT Key must be one of the following valid types: CNPJ, CPF, email, phone number, or UUID version 4. Each type has specific formatting and validation rules as outlined below.
| Key Type | Requirement | Validation Pattern |
|---|---|---|
| CNPJ | No formatting; must contain 14 characters | 14 numeric characters only |
| CPF | No formatting; must contain 11 characters | 11 numeric characters only |
| Must be a valid email format | Standard email validation | |
| Cellphone | Must follow international format with '+' prefix | ^\+[1-9]\d{1,14}$ |
| UUID v4 | Must be a valid UUID version 4 | Standard UUID v4 validation |
Protection Feature
If an invalid DICT Key is submitted, it will automatically be added to a blacklist for a duration of one hour.
Cache Mechanism
To avoid potential blocks from the BACEN DICT Control, the system caches bank account data for 3 months after the initial lookup.
Penny Test
A penny test (a 1 cent transaction) will always be performed when the bank information is captured directly from the DICT to verify that the account is valid and can receive payments. This verification is not needed when using cached bank information. Please note that the penny test will be charged as a regular transaction.
For more information on how BACEN DICT Control works, please visit the following: https://www.bcb.gov.br/content/estabilidadefinanceira/pix/API-DICT.html#section/Seguranca/Limitacao-de-requisicoes