Transfer events

What data you get for transfer.created, transfer.paid, transfer.captured, transfer.canceled, and transfer.reversed.

Fires as funds move between two balances — created and paid, then captured, canceled, or reversed.

Prop

Type

{
  "id": "tr_01J9ABCDEFGHJKMNPQRSTV",
  "object": "transfer",
  "amount": 100000,
  "application_fee_amount": 2000,
  "net_amount": 97860,
  "currency": "THB",
  "status": "paid",
  "from": {
    "customer_id": "cus_01J8XYZABCDEFGHJKMNPQR",
    "balance_id": "bal_01J8XYZABCDEFGHJKMNPQR"
  },
  "to": {
    "customer_id": "cus_01J8ABC123DEFGHJKMNPQR",
    "balance_id": "bal_01J8ABC123DEFGHJKMNPQR"
  }
}

All five events share this shape — only status differs: "paid" on .created/.paid (both fire together for the same transfer), "captured", "canceled", or "refunded" on .reversed (yes — a reversed transfer's status reads "refunded").

transfer.reversed is only reachable via a "*" subscription, not by name.