# 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](https://hookdeck.com/webhooks/stripe/mcp-events).

Agent skill: `npx skills add hookdeck/webhook-skills --skill stripe-webhooks` ([details](https://hookdeck.com/webhooks/stripe/skill))

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Stripe's official docs](https://docs.stripe.com/event-destinations).

[Overview](https://hookdeck.com/webhooks/stripe) · [Webhook events (246)](https://hookdeck.com/webhooks/stripe/events) · [MCP events](https://hookdeck.com/webhooks/stripe/mcp-events) · [Verify signatures](https://hookdeck.com/webhooks/stripe/verify) · [Production guide](https://hookdeck.com/webhooks/stripe/guide-duplicates-ordering-retries-timeouts) · [Agent skill](https://hookdeck.com/webhooks/stripe/skill)

## charge.dispute.created

Confidence: documented · Schema: official schema

Customer disputes a charge

Identified by: type field in the body · Object: `charge`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-dispute-created.json)

| Key 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` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-dispute-created.json)

## charge.captured

Confidence: documented · Schema: official schema

Previously authorized charge captured

Identified by: type field in the body · Object: `charge`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-captured.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `ch_1PgafuB7WZ01zgkWXYmPNZs8` |
| `data.object.status` | string | `succeeded` |
| `data.object.amount` | integer | `100` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-captured.json)

## charge.dispute.closed

Confidence: documented · Schema: official schema

Dispute closed as won, lost or warning_closed

Identified by: type field in the body · Object: `charge`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-dispute-closed.json)

| Key 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` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-dispute-closed.json)

## charge.dispute.funds_reinstated

Confidence: documented · Schema: official schema

Disputed funds returned to your account

Identified by: type field in the body · Object: `charge`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-dispute-funds-reinstated.json)

| Key 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` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-dispute-funds-reinstated.json)

## charge.dispute.funds_withdrawn

Confidence: documented · Schema: official schema

Funds taken from your account because of a dispute

Identified by: type field in the body · Object: `charge`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-dispute-funds-withdrawn.json)

| Key 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` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-dispute-funds-withdrawn.json)

## charge.dispute.updated

Confidence: documented · Schema: official schema

Dispute changes, usually when evidence is added

Identified by: type field in the body · Object: `charge`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-dispute-updated.json)

| Key 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` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-dispute-updated.json)

## charge.expired

Confidence: documented · Schema: official schema

Uncaptured charge expires

Identified by: type field in the body · Object: `charge`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-expired.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `ch_1PgafuB7WZ01zgkWXYmPNZs8` |
| `data.object.status` | string | `succeeded` |
| `data.object.amount` | integer | `100` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-expired.json)

## charge.failed

Confidence: documented · Schema: official schema

Charge attempt fails

Identified by: type field in the body · Object: `charge`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-failed.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `ch_1PgafuB7WZ01zgkWXYmPNZs8` |
| `data.object.status` | string | `succeeded` |
| `data.object.amount` | integer | `100` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-failed.json)

## charge.pending

Confidence: documented · Schema: official schema

Pending charge created

Identified by: type field in the body · Object: `charge`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-pending.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `ch_1PgafuB7WZ01zgkWXYmPNZs8` |
| `data.object.status` | string | `succeeded` |
| `data.object.amount` | integer | `100` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-pending.json)

## charge.refund.updated

Confidence: documented · Schema: official schema

Refund changes on selected payment methods

Identified by: type field in the body · Object: `charge`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-refund-updated.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `re_1Pgc72B7WZ01zgkWqPvrRrPE` |
| `data.object.status` | string | `succeeded` |
| `data.object.amount` | integer | `100` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-refund-updated.json)

## charge.refunded

Confidence: documented · Schema: official schema

Charge refunded, in full or in part

Identified by: type field in the body · Object: `charge`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-refunded.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `ch_1PgafuB7WZ01zgkWXYmPNZs8` |
| `data.object.status` | string | `succeeded` |
| `data.object.amount` | integer | `100` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-refunded.json)

## charge.succeeded

Confidence: documented · Schema: official schema

Charge succeeds

Identified by: type field in the body · Object: `charge`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-succeeded.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `ch_1PgafuB7WZ01zgkWXYmPNZs8` |
| `data.object.status` | string | `succeeded` |
| `data.object.amount` | integer | `100` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-succeeded.json)

## charge.updated

Confidence: documented · Schema: official schema

Charge description or metadata changes, or an asynchronous capture completes

Identified by: type field in the body · Object: `charge`

```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"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-updated.json)

| Key field | Type | Example |
|---|---|---|
| `data.object.id` | string | `ch_1PgafuB7WZ01zgkWXYmPNZs8` |
| `data.object.status` | string | `succeeded` |
| `data.object.amount` | integer | `100` |
| `data.object.created` | integer | `1234567890` |

From Stripe docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/stripe/events/charge-updated.json)

---

Not affiliated with Stripe. Facts are compiled from public sources and linked inline. [View as JSON](https://hookdeck.com/webhooks/stripe.json) · [Report a correction](https://hookdeck.com/contact)
