Stripe payout webhook events

Stripe sends 6 payout events, including payout.canceled, payout.created and payout.failed.

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

payout.canceled

documented official schema

Payout canceled

Identified by type field in the body Resource payout

stripe-payout-canceled.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1100,
      "application_fee": null,
      "application_fee_amount": null,
      "arrival_date": 1234567890,
      "automatic": true,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "created": 1234567890,
      "currency": "usd",
      "description": "STRIPE PAYOUT",
      "destination": "ba_1Pgc79B7WZ01zgkWoU5vBiXt",
      "id": "po_1Pgc79B7WZ01zgkWu1KToYf4",
      "status": "in_transit",
      "type": "bank_account"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "payout.canceled"
}

Key fields

Field Type Example
data.object.id string po_1Pgc79B7WZ01zgkWu1KToYf4
data.object.status string in_transit
data.object.type string bank_account
data.object.amount integer 1100
data.object.created integer 1234567890

Full schema: 41 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

payout.created

documented official schema

Payout created

Identified by type field in the body Resource payout

stripe-payout-created.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1100,
      "application_fee": null,
      "application_fee_amount": null,
      "arrival_date": 1234567890,
      "automatic": true,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "created": 1234567890,
      "currency": "usd",
      "description": "STRIPE PAYOUT",
      "destination": "ba_1Pgc79B7WZ01zgkWoU5vBiXt",
      "id": "po_1Pgc79B7WZ01zgkWu1KToYf4",
      "status": "in_transit",
      "type": "bank_account"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "payout.created"
}

Key fields

Field Type Example
data.object.id string po_1Pgc79B7WZ01zgkWu1KToYf4
data.object.status string in_transit
data.object.type string bank_account
data.object.amount integer 1100
data.object.created integer 1234567890

Full schema: 41 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

payout.failed

documented official schema

Payout attempt fails

Identified by type field in the body Resource payout

stripe-payout-failed.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1100,
      "application_fee": null,
      "application_fee_amount": null,
      "arrival_date": 1234567890,
      "automatic": true,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "created": 1234567890,
      "currency": "usd",
      "description": "STRIPE PAYOUT",
      "destination": "ba_1Pgc79B7WZ01zgkWoU5vBiXt",
      "id": "po_1Pgc79B7WZ01zgkWu1KToYf4",
      "status": "in_transit",
      "type": "bank_account"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "payout.failed"
}

Key fields

Field Type Example
data.object.id string po_1Pgc79B7WZ01zgkWu1KToYf4
data.object.status string in_transit
data.object.type string bank_account
data.object.amount integer 1100
data.object.created integer 1234567890

Full schema: 41 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

payout.paid

documented official schema

Payout expected to have arrived; a later payout.failed means it didn't

Identified by type field in the body Resource payout

stripe-payout-paid.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1100,
      "application_fee": null,
      "application_fee_amount": null,
      "arrival_date": 1234567890,
      "automatic": true,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "created": 1234567890,
      "currency": "usd",
      "description": "STRIPE PAYOUT",
      "destination": "ba_1Pgc79B7WZ01zgkWoU5vBiXt",
      "id": "po_1Pgc79B7WZ01zgkWu1KToYf4",
      "status": "in_transit",
      "type": "bank_account"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "payout.paid"
}

Key fields

Field Type Example
data.object.id string po_1Pgc79B7WZ01zgkWu1KToYf4
data.object.status string in_transit
data.object.type string bank_account
data.object.amount integer 1100
data.object.created integer 1234567890

Full schema: 41 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

payout.reconciliation_completed

documented official schema

Balance transactions in an automatic payout can now be queried

Identified by type field in the body Resource payout

stripe-payout-reconciliation-completed.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1100,
      "application_fee": null,
      "application_fee_amount": null,
      "arrival_date": 1234567890,
      "automatic": true,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "created": 1234567890,
      "currency": "usd",
      "description": "STRIPE PAYOUT",
      "destination": "ba_1Pgc79B7WZ01zgkWoU5vBiXt",
      "id": "po_1Pgc79B7WZ01zgkWu1KToYf4",
      "status": "in_transit",
      "type": "bank_account"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "payout.reconciliation_completed"
}

Key fields

Field Type Example
data.object.id string po_1Pgc79B7WZ01zgkWu1KToYf4
data.object.status string in_transit
data.object.type string bank_account
data.object.amount integer 1100
data.object.created integer 1234567890

Full schema: 41 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

payout.updated

documented official schema

Payout changes

Identified by type field in the body Resource payout

stripe-payout-updated.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1100,
      "application_fee": null,
      "application_fee_amount": null,
      "arrival_date": 1234567890,
      "automatic": true,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "created": 1234567890,
      "currency": "usd",
      "description": "STRIPE PAYOUT",
      "destination": "ba_1Pgc79B7WZ01zgkWoU5vBiXt",
      "id": "po_1Pgc79B7WZ01zgkWu1KToYf4",
      "status": "in_transit",
      "type": "bank_account"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "payout.updated"
}

Key fields

Field Type Example
data.object.id string po_1Pgc79B7WZ01zgkWu1KToYf4
data.object.status string in_transit
data.object.type string bank_account
data.object.amount integer 1100
data.object.created integer 1234567890

Full schema: 41 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.