Skip to main content

​
Minimum shape

{
  "id": "evt_123",
  "event": "transaction",
  "data": {
    "id": "trx_123",
    "method": "pix",
    "status": "paid",
    "amount": 1500,
    "currency": "BRL"
  }
}

​
What matters most

  • webhook event id for deduplication
  • transaction id for reconciliation
  • status for business transitions
  • method so Pix and cards can branch if necessary

​
Safe business actions

  • paid / captured: fulfill
  • canceled / expired: close the attempt
  • refunded / partially_refunded: reverse financial state
  • refused: offer retry or another method