Tipos de chave Pix
A API Magen 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.
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.