Stripe transfer webhook events

Stripe sends 3 transfer events: transfer.created, transfer.reversed and transfer.updated.

Every event here can also reach agents as an MCP event through Hookdeck: MCP events →

transfer.created

documented official schema

Transfer created

Identified by type field in the body Resource transfer

stripe-transfer-created.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1100,
      "amount_reversed": 0,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "created": 1234567890,
      "currency": "usd",
      "description": null,
      "destination": "acct_1PgafTB7WZ01zgkW",
      "destination_payment": "py_QXhWZR8SdWquhf",
      "id": "tr_1Pgc7BB7WZ01zgkWVJfE40RX",
      "livemode": false,
      "metadata": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "transfer.created"
}

Key fields

Field Type Example
data.object.id string tr_1Pgc7BB7WZ01zgkWVJfE40RX
data.object.amount integer 1100
data.object.created integer 1234567890

Full schema: 33 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

transfer.reversed

documented official schema

Transfer reversed, in full or in part

Identified by type field in the body Resource transfer

stripe-transfer-reversed.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1100,
      "amount_reversed": 0,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "created": 1234567890,
      "currency": "usd",
      "description": null,
      "destination": "acct_1PgafTB7WZ01zgkW",
      "destination_payment": "py_QXhWZR8SdWquhf",
      "id": "tr_1Pgc7BB7WZ01zgkWVJfE40RX",
      "livemode": false,
      "metadata": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "transfer.reversed"
}

Key fields

Field Type Example
data.object.id string tr_1Pgc7BB7WZ01zgkWVJfE40RX
data.object.amount integer 1100
data.object.created integer 1234567890

Full schema: 33 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

transfer.updated

documented official schema

Transfer description or metadata changes

Identified by type field in the body Resource transfer

stripe-transfer-updated.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1100,
      "amount_reversed": 0,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "created": 1234567890,
      "currency": "usd",
      "description": null,
      "destination": "acct_1PgafTB7WZ01zgkW",
      "destination_payment": "py_QXhWZR8SdWquhf",
      "id": "tr_1Pgc7BB7WZ01zgkWVJfE40RX",
      "livemode": false,
      "metadata": { … }
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "transfer.updated"
}

Key fields

Field Type Example
data.object.id string tr_1Pgc7BB7WZ01zgkWVJfE40RX
data.object.amount integer 1100
data.object.created integer 1234567890

Full schema: 33 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

Route Stripe events by type.

Event Gateway receives every Stripe delivery and filters and routes it by event type, so each service gets only the events it handles.

Not affiliated with Stripe. Facts are compiled from public sources and linked inline.