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 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
transfer.reversed
documented official schema
transfer.reversed 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
transfer.updated
documented official schema
transfer.updated 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
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.