# Shopify payments webhook events

Shopify sends 6 payments events, including `disputes/create`, `disputes/update` and `payment_schedules/due`. Every event here can also reach agents as an MCP event through Hookdeck: [MCP events](https://hookdeck.com/webhooks/shopify/mcp-events).

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

> Independent reference generated from hookdeck/webhook-registry (commit a24c8d9, 19 Nov 2026). [Shopify's official docs](https://shopify.dev/docs/apps/build/webhooks/delivery-structure).

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

## disputes/create

Confidence: documented · Schema: from Shopify docs (example)

New Shopify Payments dispute created

Identified by: x-shopify-topic header · Object: `payments`

```json
{
  "id": 285332461850802050,
  "order_id": 820982911946154500,
  "type": "chargeback",
  "amount": "11.50",
  "currency": "CAD",
  "reason": "fraudulent",
  "network_reason_code": "4837",
  "status": "under_review",
  "evidence_due_by": "2021-12-30T19:00:00-05:00",
  "evidence_sent_on": null,
  "finalized_on": null,
  "initiated_at": "2021-12-31T19:00:00-05:00"
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `285332461850802050` |
| `status` | string | `under_review` |
| `type` | string | `chargeback` |
| `amount` | string | `11.50` Watch out: Numeric string. |
| `initiated_at` | string | `2021-12-31T19:00:00-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/disputes-create.json)

## disputes/update

Confidence: documented · Schema: from Shopify docs (example)

Shopify Payments dispute changes

Identified by: x-shopify-topic header · Object: `payments`

```json
{
  "id": 285332461850802050,
  "order_id": 820982911946154500,
  "type": "chargeback",
  "amount": "11.50",
  "currency": "CAD",
  "reason": "fraudulent",
  "network_reason_code": "4837",
  "status": "under_review",
  "evidence_due_by": "2021-12-30T19:00:00-05:00",
  "evidence_sent_on": null,
  "finalized_on": null,
  "initiated_at": "2021-12-31T19:00:00-05:00"
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `285332461850802050` |
| `status` | string | `under_review` |
| `type` | string | `chargeback` |
| `amount` | string | `11.50` Watch out: Numeric string. |
| `initiated_at` | string | `2021-12-31T19:00:00-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/disputes-update.json)

## payment_schedules/due

Confidence: documented · Schema: from Shopify docs (example)

Payment schedules fall due

Identified by: x-shopify-topic header · Object: `payments`

```json
{
  "id": 606405506930370000,
  "payment_terms_id": 706405506930370000,
  "amount": "10.00",
  "currency": "USD",
  "issued_at": "2021-01-01T00:00:00-05:00",
  "due_at": "2021-01-02T00:00:00-05:00",
  "completed_at": "2021-01-02T00:00:00-05:00",
  "created_at": "2021-01-01T00:00:00-05:00",
  "updated_at": "2021-01-01T00:00:01-05:00",
  "admin_graphql_api_id": "gid://shopify/PaymentSchedule/606405506930370084"
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `606405506930370000` |
| `amount` | string | `10.00` Watch out: Numeric string. |
| `issued_at` | string | `2021-01-01T00:00:00-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/payment-schedules-due.json)

## payment_terms/create

Confidence: documented · Schema: from Shopify docs (example)

New payment terms created

Identified by: x-shopify-topic header · Object: `payments`

```json
{
  "id": 706405506930370000,
  "payment_terms_name": "Net 7",
  "payment_terms_type": "net",
  "due_in_days": 7,
  "created_at": "2021-01-01T00:00:00-05:00",
  "updated_at": "2021-01-01T00:00:01-05:00",
  "payment_schedules": [ … ],
  "admin_graphql_api_id": "gid://shopify/PaymentsPaymentFlexibilityPaymentTermsPaymentTerms/706405506930370084"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/payment-terms-create.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `706405506930370000` |
| `created_at` | string | `2021-01-01T00:00:00-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/payment-terms-create.json)

## payment_terms/delete

Confidence: documented · Schema: from Shopify docs (example)

Existing payment terms deleted

Identified by: x-shopify-topic header · Object: `payments`

```json
{
  "id": 706405506930370000
}
```



| Key field | Type | Example |
|---|---|---|
| `id` | integer | `706405506930370000` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/payment-terms-delete.json)

## payment_terms/update

Confidence: documented · Schema: from Shopify docs (example)

Payment terms change

Identified by: x-shopify-topic header · Object: `payments`

```json
{
  "id": 706405506930370000,
  "payment_terms_name": "Net 7",
  "payment_terms_type": "net",
  "due_in_days": 7,
  "created_at": "2021-01-01T00:00:00-05:00",
  "updated_at": "2021-01-01T00:00:01-05:00",
  "payment_schedules": [ … ],
  "admin_graphql_api_id": "gid://shopify/PaymentsPaymentFlexibilityPaymentTermsPaymentTerms/706405506930370084"
}
```

Trimmed sample. Full payload: [View as JSON](https://hookdeck.com/webhooks/shopify/events/payment-terms-update.json)

| Key field | Type | Example |
|---|---|---|
| `id` | integer | `706405506930370000` |
| `created_at` | string | `2021-01-01T00:00:00-05:00` |

From Shopify docs: content type `application/json`

[View as JSON](https://hookdeck.com/webhooks/shopify/events/payment-terms-update.json)

---

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