Tipos de chave Pix
A API PayZu aceita os 5 tipos oficiais de chave Pix definidos pelo
Bacen. O campo pixType informa qual tipo está sendo usado, e o
formato do pixKey muda de acordo com cada um.
Tipos disponíveis
| Tipo | Descrição | Formato | Exemplo |
|---|---|---|---|
cpf | CPF do titular (pessoa física) | 11 dígitos numéricos, sem formatação | 12345678901 |
cnpj | CNPJ do titular (pessoa jurídica) | 14 dígitos numéricos, sem formatação | 12345678901234 |
phone | Telefone celular | Padrão E.164 com código de país (55) | 5511987654321 |
email | Endereço de email | Formato de email válido | user@domain.com |
evp | Chave aleatória | UUID v4 (emitido pelo Bacen) | 123e4567-e89b-12d3-a456-426655440000 |
Validação
A API valida o formato do pixKey automaticamente conforme o pixType
informado. Se o formato não bater, retorna 400 Bad Request antes de
enviar a operação ao Bacen.
Antes de fazer um saque, recomendamos consultar a chave no DICT para validar que ela existe e confirmar o titular. Veja Consulta DICT.
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.
Códigos de erro
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.