Pagamento aprovado (cartão)
Cobre um valor terminando em
00 com um cartão aprovado (...1111).
Espere: transação paid, webhook transaction.paid.Pagamento recusado (cartão)
Repita com um cartão de recusa (
...1002 = CARD_DECLINED).
Espere: transação refused, webhook transaction.refused, e sua UI tratando o erro.Falha retryável (cartão)
Use
...2001 (PROCESSING_ERROR).
Espere: falha que permite nova tentativa — valide seu fluxo de retry.PIX que paga sozinho
Crie um PIX com valor terminando em
07 (ex.: R$ 100,07).
Espere: waiting_payment → paid após o delay; webhook transaction.paid.PIX/boleto que expira
Use valor terminando em
17.
Espere: waiting_payment → expira/cancela; trate o vencimento.Estado aguardando (manual)
Use valor terminando em
27 (ou modo manual) e depois Simular Pagamento no painel.
Espere: controlar a transição waiting_payment → paid na hora que quiser.Estorno (refund)
Estorne um pagamento aprovado via
POST /transactions/{id}/refund.
Espere: refund processado, webhook de estorno, status da transação atualizado.Chargeback
Em um pagamento de cartão aprovado, abra a contestação (valor
...31 ou painel) e force o
desfecho won/lost.
Espere: transação em chargeback, débito na carteira, fluxo de defesa.Webhooks de ponta a ponta
Confirme que seu endpoint recebe e valida a assinatura de cada evento acima.
Veja Webhooks.
Tratou aprovação, recusa, retry, PIX, expiração, estorno e chargeback? Sua integração está pronta
para produção. Troque as URLs base e a API key e siga em frente.