Pix key types
The five official types the Central Bank accepts, the format each one requires, and how the API rejects a malformed key upfront, before it ever reaches the Central Bank.
The PayZu 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 Pix payment, we recommend looking up the key in DICT to validate that it exists and confirm the holder. See DICT lookup.