PayZu CâmbioSegurança
Autenticação
Autentique cada chamada com a chave de API da sua conta, sem rota de login nem troca de chave por token.
Como obter a chave
Você cria a chave no painel da Exchange, em Conta e ajustes, na entrada API e webhooks.
A chave aparece uma única vez, logo depois de criada.
Copie e guarde no cofre de segredos da sua aplicaçã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.exchange.payzu.com.br/v1/api-key \
-H "Authorization: Bearer SUA_CHAVE_DE_API"json
{
"id": "k7q2m4xw3n5b6c2a",
"name": "ERP",
"accountNumber": "900123",
"ipAllowlist": ["203.0.113.10"],
"expiresAt": "2027-02-08T12:00:00.000Z",
"createdAt": "2026-11-10T12:00:00.000Z"
}Referência: Consultar chave de API
Validade e revogação
| Situação | Resposta |
|---|---|
A data de expiresAt passou | key_expired |
| Você revogou a chave no painel | key_revoked |
Erros de autenticação
| Código | HTTP |
|---|---|
unauthorized | 401 |
key_revoked | 401 |
key_expired | 401 |
api_not_enabled | 403 |
ip_not_allowed | 403 |
insufficient_scope | 403 |
Todos os códigos do PayZu Câmbio estão no Catálogo de erros.