Autenticação
Autentique cada chamada com o token da sua conta, sem rota de login nem troca de chave por token.
Como obter o token
| Ambiente | Onde gerar | Como chega |
|---|---|---|
| Produção | No painel da PayZu, em Credenciais. | A PayZu envia ao e-mail informado um link de uso único com o token, e a senha desse link aparece na tela do painel. |
| Sandbox | Em Credencial de sandbox, aqui na documentação. | Informe o e-mail, digite o código recebido e copie o token, que vale 24 horas e só em https://pix.sandbox.payzu.dev/v1. |
O link do token de produção expira.
Abra assim que o e-mail chegar. Na abertura da conta, a PayZu também pode entregar um token pelo mesmo tipo de link.
O que vai em cada chamada
Authorization: Bearer SEU_TOKEN
Content-Type: application/jsonO Content-Type vale para as rotas com corpo JSON. O envio de defesa MED é a exceção e vai em multipart/form-data.
Para testar o token, abra Consultar os dados da conta na Referência API, cole o token em Credenciais e clique em Try It!.
Validade e revogação
O token não tem data de expiração. Ele para de funcionar quando é revogado no painel, em Credenciais, ou quando a conta deixa de estar ativa. Nos dois casos, a resposta passa a ser 401.
Erros de autenticação
| Código | HTTP | Mensagem |
|---|---|---|
PZA100 | 401 | Unauthorized |
PZA200 | 403 | Forbidden |
PZA203 | 403 | Acesso não permitido a partir do endereço de IP 203.0.113.10. |
PZA205 | 403 | Conta com token de saque exige IP cadastrado na whitelist. Cadastre o IP de origem (203.0.113.10) antes de operar. |
PZA206 | 403 | Conta aguardando assinatura do contrato. Assine o contrato enviado ao representante legal para liberar as operações. |
{
"status": "ERROR",
"error": "Unauthorized",
"errorCode": "PZA100",
"message": "Unauthorized",
"statusCode": 401,
"requestId": "cmbz0f8qk0001js04hp3e2n0f"
}Toda resposta de erro traz requestId, que identifica a chamada de forma única. Informe esse valor ao falar com o suporte.
Todos os códigos do PayZu Pix estão no Catálogo de erros.