Transfer Events

​

Example delivery payload

{
  "id": "evt_payout_1001",
  "type": "payout.transferred",
  "api_version": "v2",
  "data": {
    "object": {
      "id": "018f1f2e-7b45-7c9a-8d3e-1a2b3c4d5e72",
      "status": "paid",
      "type": "pix",
      "amount": 1200,
      "fee": 50,
      "net_amount": 1150,
      "transferred_at": "2026-03-16T14:05:00.000Z"
    }
  }
}

​

ACK response

{
  "received": true
}

​

Event names emitted today

• payout.created
• payout.in_analysis
• payout.processing
• payout.transferred
• payout.failed
• payout.rejected — cancelled at the banking partner after submission
• payout.canceled — stopped before or reversed after execution

​

Common ingestion error

{
  "error": "missing_event_id"
}

​

Mapping guidance

• payout.transferred means the resource is settled with status paid.
• payout.failed usually maps to resource status error.
• payout.rejected maps to resource status rejected: the banking partner cancelled the payout after submission. The funds are not returned to your balance automatically, so check your balance and contact support before re-sending.
• payout.canceled maps to resource status cancelled: the payout was stopped before execution or reversed afterwards. A stopped payout returns the funds to your balance; after a reversal, confirm your balance before closing the request.
• Reconcile when operator state and webhook state disagree.