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
charge.dispute.created Customer disputes a charge
Identified by type field in the body
Resource charge
{
"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
charge.captured
documented official schema
charge.captured Previously authorized charge captured
Identified by type field in the body
Resource charge
{
"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
charge.dispute.closed
documented official schema
charge.dispute.closed Dispute closed as won, lost or warning_closed
Identified by type field in the body
Resource charge
{
"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
charge.dispute.funds_reinstated
documented official schema
charge.dispute.funds_reinstated Disputed funds returned to your account
Identified by type field in the body
Resource charge
{
"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
charge.dispute.funds_withdrawn
documented official schema
charge.dispute.funds_withdrawn Funds taken from your account because of a dispute
Identified by type field in the body
Resource charge
{
"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
charge.dispute.updated
documented official schema
charge.dispute.updated Dispute changes, usually when evidence is added
Identified by type field in the body
Resource charge
{
"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
charge.expired
documented official schema
charge.expired Uncaptured charge expires
Identified by type field in the body
Resource charge
{
"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
charge.failed
documented official schema
charge.failed Charge attempt fails
Identified by type field in the body
Resource charge
{
"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
charge.pending
documented official schema
charge.pending Pending charge created
Identified by type field in the body
Resource charge
{
"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
charge.refund.updated
documented official schema
charge.refund.updated Refund changes on selected payment methods
Identified by type field in the body
Resource charge
{
"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
charge.refunded
documented official schema
charge.refunded Charge refunded, in full or in part
Identified by type field in the body
Resource charge
{
"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
charge.succeeded
documented official schema
charge.succeeded Charge succeeds
Identified by type field in the body
Resource charge
{
"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
charge.updated
documented official schema
charge.updated Charge description or metadata changes, or an asynchronous capture completes
Identified by type field in the body
Resource charge
{
"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
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.