1
Leia antes de escrever
Rotas
GET não mudam nada. Valide autenticação, paginação e o formato das respostas com elas: GET /v1/company, GET /v1/products, GET /v1/transactions, GET /v1/balance.2
Teste o webhook sem venda
POST /v1/webhooks/{webhookId}/test manda um evento completo para o seu endpoint, com scope: "test" e IDs de teste como test_transaction_id. Teste quantos eventos quiser, sem cobrar ninguém.3
Faça uma venda de verdade, pequena
Para ver o fluxo de ponta a ponta, crie no painel um produto de teste com uma oferta gratuita ou de valor baixo e compre você mesmo pelo checkout. A oferta gratuita gera venda aprovada, com todos os webhooks, sem passar pelo cartão.
4
Desfaça o que criou
Exclua o produto de teste e estorne a venda paga por
POST /v1/transactions/{transactionId}/refund. Venda gratuita não tem estorno e fica fora das métricas.Boas práticas
- Use uma chave de API só para testes e revogue no fim.
- Registre o
idde cada evento recebido e processe uma vez só. O mesmo evento pode chegar mais de uma vez. - Antes de escrever em massa, rode a operação em um item e confira o resultado.