PayZu CellSegurança
Autenticação
Nesta página
Como obter a chaveO que vai em cada chamadaIP de origemQuando a chave é recusadaErros de autenticaçãoAutentique 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çalho | Valor | Quando |
|---|---|---|
Authorization | Bearer SUA_CHAVE_DE_API | Em toda chamada |
Content-Type | application/json | Nas 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ção | Có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 expirada | PZC010, com a mesma resposta em todos os casos |
| Chamada de um IP fora da lista da chave | PZC012 |
| Chamador sem acesso ao recurso | PZC011 |
Erros de autenticação
| Código | HTTP | Mensagem |
|---|---|---|
PZC010 | 401 | Credencial ausente ou inválida. |
PZC011 | 403 | O chamador não tem acesso a este recurso. |
PZC012 | 403 | IP de origem fora da lista da chave. |
PZC013 | 403 | A chave não tem acesso a esta operação. |
O formato do corpo de erro está em Erros.