PayZu CellSegurança

Autenticação


Nesta páginaComo obter a chaveO que vai em cada chamadaIP de origemQuando a chave é recusadaErros de autenticação

Autentique cada chamada com a sua chave de API, sem rota de login nem troca da chave por token.

Como obter a chave

O PayZu Cell emite a sua chave de API, uma para testes e outra para produção. Veja Ambientes de teste e produção.

O que vai em cada chamada

CabeçalhoValorQuando
AuthorizationBearer SUA_CHAVE_DE_APIEm toda chamada
Content-Typeapplication/jsonNas rotas com corpo JSON
bash
curl https://api.payzucell.com.br/v1/me \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

Para testar a chave, chame Consultar a identidade da chave.

IP de origem

  • Com lista de IPs: a chamada precisa sair de um dos endereços da lista.
  • Sem lista: a chave aceita chamadas de qualquer origem.

Diante de uma recusa por IP, confira o IP de saída do seu servidor.

O bloqueio é pelo IP de origem: outra chave com a mesma lista recebe a mesma resposta.

Quando a chave é recusada

SituaçãoCódigo
Chamada sem o cabeçalho Authorization, com outro esquema no lugar de Bearer, ou com chave que a API não reconhece, revogada ou expiradaPZC010, com a mesma resposta em todos os casos
Chamada de um IP fora da lista da chavePZC012
Chamador sem acesso ao recursoPZC011

Erros de autenticação

CódigoHTTPMensagem
PZC010401Credencial ausente ou inválida.
PZC011403O chamador não tem acesso a este recurso.
PZC012403IP de origem fora da lista da chave.
PZC013403A chave não tem acesso a esta operação.

O formato do corpo de erro está em Erros.