Pago aprobado (tarjeta)
Cobra un monto que termine en
00 con una tarjeta aprobada (...1111).
Espera: transacción paid, webhook transaction.paid.Pago rechazado (tarjeta)
Repite con una tarjeta de rechazo (
...1002 = CARD_DECLINED).
Espera: transacción refused, webhook transaction.refused, y tu UI manejando el error.Falla reintentable (tarjeta)
Usa
...2001 (PROCESSING_ERROR).
Espera: una falla que permite nuevo intento — valida tu flujo de retry.PIX que se paga solo
Crea un PIX con monto que termine en
07 (ej.: R$ 100,07).
Espera: waiting_payment → paid tras el delay; webhook transaction.paid.PIX/boleto que expira
Usa un monto que termine en
17.
Espera: waiting_payment → expira/cancela; maneja el vencimiento.Estado en espera (manual)
Usa un monto que termine en
27 (o el modo manual) y luego Simular Pago en el panel.
Espera: controlar la transición waiting_payment → paid cuando lo desees.Reembolso (refund)
Reembolsa un pago aprobado mediante
POST /transactions/{id}/refund.
Espera: refund procesado, webhook de reembolso, estado de la transacción actualizado.Contracargo (chargeback)
En un pago de tarjeta aprobado, abre la disputa (monto
...31 o desde el panel) y fuerza el
resultado won/lost.
Espera: transacción en chargeback, débito en la billetera, flujo de defensa.Webhooks de extremo a extremo
Confirma que tu endpoint recibe y valida la firma de cada evento anterior.
Consulta Webhooks.
¿Manejaste aprobación, rechazo, retry, PIX, expiración, reembolso y contracargo? Tu integración está lista
para producción. Cambia las URLs base y la API key, y adelante.