Como criar e gerenciar chaves de API para autenticação
Chaves de API são o mecanismo de autenticação para integrar com a API PayHub. Cada chave é composta por um par:
pk_live_...): identifica a chave nas requisiçõessk_live_...): segredo usado na autenticaçãoA Secret Key é exibida apenas uma vez no momento da criação. Se perdê-la, será necessário revogar a chave e criar uma nova.
curl -X POST https://api.payhubr.com/v1/api-keys \
-H "Authorization: Basic {credentials}" \
-H "Content-Type: application/json" \
-d '{
"name": "Integração Produção",
"ip_whitelist": ["203.0.113.10"]
}'const response = await fetch('https://api.payhubr.com/v1/api-keys', {
method: 'POST',
headers: {
'Authorization': `Basic ${credentials}`,
'Content-Type': 'application/json',
},
body: JSON.stringify
{
"data": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"name": "Integração Produção",
"public_key": "pk_live_abc123def456",
"secret_key": "sk_live_xyz789ghi012",
"is_active": true,
"created_at": "2026-02-11T10:00:00Z"
}
}| Campo | Obrigatório | Descrição |
|---|---|---|
name | Sim | Nome identificador da chave (1-50 caracteres) |
ip_whitelist | Não | Lista de IPs autorizados (IPv4) |
curl -X GET https://api.payhubr.com/v1/api-keys \
-H "Authorization: Basic {credentials}"A Secret Key nunca é retornada em listagens. Apenas a Public Key é visível após a criação.
Você pode alterar o nome, ativar/desativar a chave ou modificar a whitelist de IPs:
curl -X PATCH https://api.payhubr.com/v1/api-keys/{id} \
-H "Authorization: Basic {credentials}" \
-H "Content-Type: application/json" \
-d '{
"name": "Novo Nome",
"is_active": false,
"ip_whitelist": ["203.0.113.10", "203.0.113.20"]
}'Para remover a whitelist e permitir requisições de qualquer IP:
{
"ip_whitelist": null
}A revogação remove permanentemente a chave:
curl -X DELETE https://api.payhubr.com/v1/api-keys/{id} \
-H "Authorization: Basic {credentials}"A revogação é irreversível. Todas as integrações que utilizam essa chave deixarão de funcionar imediatamente.
Crie chaves separadas para desenvolvimento, staging e produção.
Use a whitelist para limitar o acesso apenas aos IPs dos seus servidores.
Crie uma nova chave, migre a integração e revogue a antiga.
Acompanhe o campo last_used_at para identificar chaves sem uso.