Antes de escrever código
Prepare o terreno.
- Conta de comerciante criada e verificação de documentos aprovada.
- Métodos de pagamento decididos e activados.
- Endereço de webhook em HTTPS, acessível a partir da internet.
- Ambiente separado para testes, com a sua própria chave.
Durante a integração
Cobre estes pontos no código.
- Chave guardada em variável de ambiente, nunca no navegador.
- Chave de idempotência única por encomenda.
- Todos os estados tratados, incluindo em revisão e bloqueado.
- Assinatura do webhook validada antes de ler o corpo.
- Eventos processados uma só vez, pelo identificador.
- Mensagens de erro úteis para o cliente, em pt e en.
Testes obrigatórios
Não vá para produção sem passar por todos.
- Pagamento aprovado e entrega libertada.
- Pagamento recusado e nada entregue.
- Cliente não confirma dentro do prazo.
- Pedido duplicado com a mesma chave de idempotência.
- Reembolso total e parcial.
- Webhook com assinatura errada rejeitado.
No dia do arranque
Troque a chave, confirme que a de teste desapareceu do código, faça uma transacção real de valor pequeno, verifique o registo no painel e faça um levantamento de teste. Tenha um plano simples para desligar os pagamentos caso algo corra mal.