PayZu PixCertificados e segurança

Autenticação


Nesta páginaComo obter o tokenO que vai em cada chamadaValidade e revogaçãoErros de 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

AmbienteOnde gerarComo chega
ProduçãoNo 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.
SandboxEm 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

bash
Authorization: Bearer SEU_TOKEN
Content-Type: application/json

O 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ódigoHTTPMensagem
PZA100401Unauthorized
PZA200403Forbidden
PZA203403Acesso não permitido a partir do endereço de IP 203.0.113.10.
PZA205403Conta com token de saque exige IP cadastrado na whitelist. Cadastre o IP de origem (203.0.113.10) antes de operar.
PZA206403Conta aguardando assinatura do contrato. Assine o contrato enviado ao representante legal para liberar as operações.
json
{
  "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.