Pix key types
The Magen 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 (Mecanismo Especial de Devolução)
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.
Glossário
Termos, siglas, status e campos que aparecem na Magen. Se você ficou travado em uma sigla do Bacen ou um campo da API, é aqui. Tudo em PT com o nome original quando relevante.