Stripe charge webhook events

Stripe sends 13 charge events, covering captures, refunds and disputes. charge.dispute.created tells you a customer has disputed a charge.

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

charge.dispute.created

documented official schema

Customer disputes a charge

Identified by type field in the body Resource charge

stripe-charge-dispute-created.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1000,
      "balance_transactions": [ … ],
      "charge": "ch_1PgafuB7WZ01zgkWXYmPNZs8",
      "created": 1234567890,
      "currency": "usd",
      "evidence": { … },
      "evidence_details": { … },
      "id": "dp_1Pgc71B7WZ01zgkWMevJiAUx",
      "is_charge_refundable": true,
      "livemode": false,
      "metadata": { … },
      "status": "warning_needs_response"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "charge.dispute.created"
}

Key fields

Field Type Example
data.object.id string dp_1Pgc71B7WZ01zgkWMevJiAUx
data.object.status string warning_needs_response
data.object.amount integer 1000
data.object.created integer 1234567890

Full schema: 71 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

charge.captured

documented official schema

Previously authorized charge captured

Identified by type field in the body Resource charge

stripe-charge-captured.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 100,
      "amount_captured": 0,
      "amount_refunded": 0,
      "application": null,
      "application_fee": null,
      "application_fee_amount": null,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "billing_details": { … },
      "calculated_statement_descriptor": null,
      "created": 1234567890,
      "id": "ch_1PgafuB7WZ01zgkWXYmPNZs8",
      "status": "succeeded"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "charge.captured"
}

Key fields

Field Type Example
data.object.id string ch_1PgafuB7WZ01zgkWXYmPNZs8
data.object.status string succeeded
data.object.amount integer 100
data.object.created integer 1234567890

Full schema: 164 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

charge.dispute.closed

documented official schema

Dispute closed as won, lost or warning_closed

Identified by type field in the body Resource charge

stripe-charge-dispute-closed.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1000,
      "balance_transactions": [ … ],
      "charge": "ch_1PgafuB7WZ01zgkWXYmPNZs8",
      "created": 1234567890,
      "currency": "usd",
      "evidence": { … },
      "evidence_details": { … },
      "id": "dp_1Pgc71B7WZ01zgkWMevJiAUx",
      "is_charge_refundable": true,
      "livemode": false,
      "metadata": { … },
      "status": "warning_needs_response"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "charge.dispute.closed"
}

Key fields

Field Type Example
data.object.id string dp_1Pgc71B7WZ01zgkWMevJiAUx
data.object.status string warning_needs_response
data.object.amount integer 1000
data.object.created integer 1234567890

Full schema: 71 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

charge.dispute.funds_reinstated

documented official schema

Disputed funds returned to your account

Identified by type field in the body Resource charge

stripe-charge-dispute-funds-reinstated.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1000,
      "balance_transactions": [ … ],
      "charge": "ch_1PgafuB7WZ01zgkWXYmPNZs8",
      "created": 1234567890,
      "currency": "usd",
      "evidence": { … },
      "evidence_details": { … },
      "id": "dp_1Pgc71B7WZ01zgkWMevJiAUx",
      "is_charge_refundable": true,
      "livemode": false,
      "metadata": { … },
      "status": "warning_needs_response"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "charge.dispute.funds_reinstated"
}

Key fields

Field Type Example
data.object.id string dp_1Pgc71B7WZ01zgkWMevJiAUx
data.object.status string warning_needs_response
data.object.amount integer 1000
data.object.created integer 1234567890

Full schema: 71 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

charge.dispute.funds_withdrawn

documented official schema

Funds taken from your account because of a dispute

Identified by type field in the body Resource charge

stripe-charge-dispute-funds-withdrawn.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1000,
      "balance_transactions": [ … ],
      "charge": "ch_1PgafuB7WZ01zgkWXYmPNZs8",
      "created": 1234567890,
      "currency": "usd",
      "evidence": { … },
      "evidence_details": { … },
      "id": "dp_1Pgc71B7WZ01zgkWMevJiAUx",
      "is_charge_refundable": true,
      "livemode": false,
      "metadata": { … },
      "status": "warning_needs_response"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "charge.dispute.funds_withdrawn"
}

Key fields

Field Type Example
data.object.id string dp_1Pgc71B7WZ01zgkWMevJiAUx
data.object.status string warning_needs_response
data.object.amount integer 1000
data.object.created integer 1234567890

Full schema: 71 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

charge.dispute.updated

documented official schema

Dispute changes, usually when evidence is added

Identified by type field in the body Resource charge

stripe-charge-dispute-updated.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 1000,
      "balance_transactions": [ … ],
      "charge": "ch_1PgafuB7WZ01zgkWXYmPNZs8",
      "created": 1234567890,
      "currency": "usd",
      "evidence": { … },
      "evidence_details": { … },
      "id": "dp_1Pgc71B7WZ01zgkWMevJiAUx",
      "is_charge_refundable": true,
      "livemode": false,
      "metadata": { … },
      "status": "warning_needs_response"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "charge.dispute.updated"
}

Key fields

Field Type Example
data.object.id string dp_1Pgc71B7WZ01zgkWMevJiAUx
data.object.status string warning_needs_response
data.object.amount integer 1000
data.object.created integer 1234567890

Full schema: 71 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

charge.expired

documented official schema

Uncaptured charge expires

Identified by type field in the body Resource charge

stripe-charge-expired.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 100,
      "amount_captured": 0,
      "amount_refunded": 0,
      "application": null,
      "application_fee": null,
      "application_fee_amount": null,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "billing_details": { … },
      "calculated_statement_descriptor": null,
      "created": 1234567890,
      "id": "ch_1PgafuB7WZ01zgkWXYmPNZs8",
      "status": "succeeded"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "charge.expired"
}

Key fields

Field Type Example
data.object.id string ch_1PgafuB7WZ01zgkWXYmPNZs8
data.object.status string succeeded
data.object.amount integer 100
data.object.created integer 1234567890

Full schema: 164 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

charge.failed

documented official schema

Charge attempt fails

Identified by type field in the body Resource charge

stripe-charge-failed.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 100,
      "amount_captured": 0,
      "amount_refunded": 0,
      "application": null,
      "application_fee": null,
      "application_fee_amount": null,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "billing_details": { … },
      "calculated_statement_descriptor": null,
      "created": 1234567890,
      "id": "ch_1PgafuB7WZ01zgkWXYmPNZs8",
      "status": "succeeded"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "charge.failed"
}

Key fields

Field Type Example
data.object.id string ch_1PgafuB7WZ01zgkWXYmPNZs8
data.object.status string succeeded
data.object.amount integer 100
data.object.created integer 1234567890

Full schema: 164 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

charge.pending

documented official schema

Pending charge created

Identified by type field in the body Resource charge

stripe-charge-pending.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 100,
      "amount_captured": 0,
      "amount_refunded": 0,
      "application": null,
      "application_fee": null,
      "application_fee_amount": null,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "billing_details": { … },
      "calculated_statement_descriptor": null,
      "created": 1234567890,
      "id": "ch_1PgafuB7WZ01zgkWXYmPNZs8",
      "status": "succeeded"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "charge.pending"
}

Key fields

Field Type Example
data.object.id string ch_1PgafuB7WZ01zgkWXYmPNZs8
data.object.status string succeeded
data.object.amount integer 100
data.object.created integer 1234567890

Full schema: 164 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

charge.refund.updated

documented official schema

Refund changes on selected payment methods

Identified by type field in the body Resource charge

stripe-charge-refund-updated.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 100,
      "balance_transaction": null,
      "charge": "ch_1PgafuB7WZ01zgkWXYmPNZs8",
      "created": 1234567890,
      "currency": "usd",
      "destination_details": { … },
      "id": "re_1Pgc72B7WZ01zgkWqPvrRrPE",
      "metadata": { … },
      "object": "refund",
      "payment_intent": null,
      "reason": null,
      "status": "succeeded"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "charge.refund.updated"
}

Key fields

Field Type Example
data.object.id string re_1Pgc72B7WZ01zgkWqPvrRrPE
data.object.status string succeeded
data.object.amount integer 100
data.object.created integer 1234567890

Full schema: 33 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

charge.refunded

documented official schema

Charge refunded, in full or in part

Identified by type field in the body Resource charge

stripe-charge-refunded.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 100,
      "amount_captured": 0,
      "amount_refunded": 0,
      "application": null,
      "application_fee": null,
      "application_fee_amount": null,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "billing_details": { … },
      "calculated_statement_descriptor": null,
      "created": 1234567890,
      "id": "ch_1PgafuB7WZ01zgkWXYmPNZs8",
      "status": "succeeded"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "charge.refunded"
}

Key fields

Field Type Example
data.object.id string ch_1PgafuB7WZ01zgkWXYmPNZs8
data.object.status string succeeded
data.object.amount integer 100
data.object.created integer 1234567890

Full schema: 164 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

charge.succeeded

documented official schema

Charge succeeds

Identified by type field in the body Resource charge

stripe-charge-succeeded.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 100,
      "amount_captured": 0,
      "amount_refunded": 0,
      "application": null,
      "application_fee": null,
      "application_fee_amount": null,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "billing_details": { … },
      "calculated_statement_descriptor": null,
      "created": 1234567890,
      "id": "ch_1PgafuB7WZ01zgkWXYmPNZs8",
      "status": "succeeded"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "charge.succeeded"
}

Key fields

Field Type Example
data.object.id string ch_1PgafuB7WZ01zgkWXYmPNZs8
data.object.status string succeeded
data.object.amount integer 100
data.object.created integer 1234567890

Full schema: 164 fields.

From Stripe docs

  • Content type application/json

Send example to Inspect → View as JSON

charge.updated

documented official schema

Charge description or metadata changes, or an asynchronous capture completes

Identified by type field in the body Resource charge

stripe-charge-updated.json
{
  "api_version": "2026-10-28.endive",
  "created": 1234567890,
  "data": {
    "object": {
      "amount": 100,
      "amount_captured": 0,
      "amount_refunded": 0,
      "application": null,
      "application_fee": null,
      "application_fee_amount": null,
      "balance_transaction": "txn_1PgaxNB7WZ01zgkWEV3TLf40",
      "billing_details": { … },
      "calculated_statement_descriptor": null,
      "created": 1234567890,
      "id": "ch_1PgafuB7WZ01zgkWXYmPNZs8",
      "status": "succeeded"
    }
  },
  "id": "evt_1Pgc76B7WZ01zgkWwyRHS12y",
  "livemode": false,
  "object": "event",
  "pending_webhooks": 0,
  "request": { … },
  "type": "charge.updated"
}

Key fields

Field Type Example
data.object.id string ch_1PgafuB7WZ01zgkWXYmPNZs8
data.object.status string succeeded
data.object.amount integer 100
data.object.created integer 1234567890

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