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 paid vindo 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 id do evento.
  • Confira que o pagamento do evento é o do seu pedido (pelo id guardado ou pelo external_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 a Idempotency-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.