Pix key types
The Pix Processamento API accepts the 5 official Pix key types defined by
Bacen. The pixType field indicates which type is being used, and the
format of pixKey changes according to each one.
Available types
| Type | Description | Format | Example |
|---|---|---|---|
cpf | Holder's CPF (individual) | 11 numeric digits, no formatting | 12345678901 |
cnpj | Holder's CNPJ (legal entity) | 14 numeric digits, no formatting | 12345678901234 |
phone | Mobile phone | E.164 standard with country code (55) | 5511987654321 |
email | Email address | Valid email format | user@domain.com |
evp | Random key | UUID v4 (issued by Bacen) | 123e4567-e89b-12d3-a456-426655440000 |
Validation
The API validates the pixKey format automatically according to the
pixType provided. If the format does not match, it returns 400 Bad Request before
sending the operation to Bacen.
Before making a withdrawal, we recommend looking up the key in DICT to validate that it exists and confirm the holder. See DICT lookup.
MED (Special Refund Mechanism)
Procedimento do Bacen para proteger usuários Pix em casos de fraude, golpe ou transações não autorizadas. Quando uma atividade suspeita é identificada, a instituição do pagador abre um processo formal pedindo o estorno do valor.
Error codes
Catálogo dos códigos de erro (errorCode) retornados ao cliente, com o HTTP, a mensagem e o que fazer. Apenas os códigos que chegam na resposta das rotas /v1.