Pular para o conteúdo principal
Use o webhook para saber quando consultar e a transação para saber qual é o estado atual.

Guarde as relações

No seu banco, mantenha o identificador do pedido, a empresa, o link.id e os identificadores de transação encontrados. Um link reutilizável pode produzir vários pagamentos; não trate seu slug como uma transação única.
1

Aceite somente eventos válidos

Verifique a assinatura sobre o corpo original. Separe eventos de teste, quando marcados com test: true, para que não liberem pedidos reais.
2

Consulte a transação

Para eventos transaction.*, use data.id em GET /api/transactions/{id}/, com a chave da empresa correspondente.
3

Valide o contexto

Confira o vínculo com seu pedido, o valor esperado e a situação retornada. A resposta da API de transações usa centavos.
4

Atualize uma única vez

Faça a atualização do pedido e o registro de processamento na mesma transação de banco, com restrição de unicidade ou bloqueio apropriado. Uma reentrega não deve liberar o serviço novamente.

Trate cada resultado

Quando houver uma lacuna

Use a listagem paginada para reconciliar períodos em que seu endpoint ficou indisponível. O SDK atual oferece filtros por status, busca e cliente; não invente um filtro por data que o método não expõe. Evite marcar um pagamento como recusado apenas porque seu servidor ainda não recebeu um webhook.