{
"id": "evt_abc123",
"type": "transfer.state_changed",
"createdAt": "2026-07-04T12:00:00.000Z",
"attempt": 1,
"resource": {
"type": "transfer",
"id": "tr_abc123"
},
"data": {
"object": {
"id": "tr_abc123",
"customerId": "cus_abc123",
"state": "processing",
"createdAt": "2026-07-04T12:00:00.000Z",
"updatedAt": "2026-07-04T12:30:00.000Z"
},
"previous": {
"state": "awaiting_funds"
}
}
}Webhook events
Transfer state changed
Triggered when a v3 transfer changes public state.
WEBHOOK
transfer.state_changed
{
"id": "evt_abc123",
"type": "transfer.state_changed",
"createdAt": "2026-07-04T12:00:00.000Z",
"attempt": 1,
"resource": {
"type": "transfer",
"id": "tr_abc123"
},
"data": {
"object": {
"id": "tr_abc123",
"customerId": "cus_abc123",
"state": "processing",
"createdAt": "2026-07-04T12:00:00.000Z",
"updatedAt": "2026-07-04T12:30:00.000Z"
},
"previous": {
"state": "awaiting_funds"
}
}
}Verify the raw request body with your endpoint signing secret and the
svix-id, svix-timestamp, and svix-signature headers before you trust this event. See Verify before parsing.Body
application/json
Stable webhook event id for deduplication.
Allowed value:
"transfer.state_changed"Envelope attempt value; currently always 1 and unchanged by delivery retries.
Available options:
1 Show child attributes
Show child attributes
Show child attributes
Show child attributes
Response
200
Webhook accepted by the merchant endpoint.