Referência
Boas práticas de segurança
As regras que protegem o seu dinheiro e os dados dos seus clientes. Siga todas.
A chave fica só no servidor
- Guarde a chave numa variável de ambiente ou num cofre de segredos.
- Nunca coloque a chave no navegador, no aplicativo, no repositório de código, em prints ou em logs.
- Dê a cada chave só os escopos que ela precisa.
- Se a chave vazar, revogue no painel na hora e crie outra.
Nunca confie no navegador
- Calcule o valor no servidor, a partir do pedido. Ignore preços, totais e descontos que vêm do navegador.
- O navegador nunca chama a API. Ele fala só com o seu servidor.
- Libere o pedido só com o status
paidvindo do webhook validado ou da consulta pela API. Nunca porque a tela do cliente mostrou sucesso.
Valide todo webhook
- Confira a assinatura de cada webhook antes de usar o conteúdo. Recuse se a assinatura não bater ou se o horário estiver velho.
- Ignore eventos repetidos pelo
iddo evento. - Confira que o pagamento do evento é o do seu pedido (pelo
idguardado ou peloexternal_id). - Veja Webhooks.
Guarde o id do pagamento
Guarde o id devolvido pela API junto com o pedido. Use esse id para consultar o status e para ligar cada webhook ao pedido certo.
Use HTTPS e repita com cuidado
- Seu endereço de webhook precisa ser HTTPS.
- Em todo
POST, envie aIdempotency-Key. Ao repetir, use a mesma chave. - Repita só erros temporários, com espera crescente.
Proteja os dados do cliente
Envie só os dados que a API pede. Não registre CPF ou CNPJ completo nos seus logs.