shopify-webhook-schemas 0.2.9 → 0.3.2

package/metadatas/2026-01/refunds/create.json

@@ -0,0 +1,527 @@
+{
+  "access_scopes": [
+    "orders",
+    "marketplace_orders",
+    "buyer_membership_orders"
+  ],
+  "available_on": [
+    "graphql",
+    "rest",
+    "toml"
+  ],
+  "deprecated": false,
+  "description": "Occurs whenever a new refund is created without errors on an order, independent from the movement of money.",
+  "name": "refunds/create",
+  "pii": [
+    "customer"
+  ],
+  "related_resource": "Refund",
+  "response": {
+    "id": 890088186047892400,
+    "order_id": 820982911946154500,
+    "created_at": "2021-12-31T19:00:00-05:00",
+    "note": "Things were damaged",
+    "user_id": 548380009,
+    "processed_at": "2021-12-31T19:00:00-05:00",
+    "duties": [],
+    "total_duties_set": {
+      "shop_money": {
+        "amount": "0.00",
+        "currency_code": "USD"
+      },
+      "presentment_money": {
+        "amount": "0.00",
+        "currency_code": "USD"
+      }
+    },
+    "return": null,
+    "restock": false,
+    "refund_shipping_lines": [],
+    "admin_graphql_api_id": "gid://shopify/Refund/890088186047892319",
+    "order_adjustments": [],
+    "refund_line_items": [
+      {
+        "id": 487817672276298600,
+        "quantity": 1,
+        "line_item_id": 487817672276298560,
+        "location_id": null,
+        "restock_type": "no_restock",
+        "subtotal": 89.99,
+        "total_tax": 0,
+        "subtotal_set": {
+          "shop_money": {
+            "amount": "89.99",
+            "currency_code": "USD"
+          },
+          "presentment_money": {
+            "amount": "89.99",
+            "currency_code": "USD"
+          }
+        },
+        "total_tax_set": {
+          "shop_money": {
+            "amount": "0.00",
+            "currency_code": "USD"
+          },
+          "presentment_money": {
+            "amount": "0.00",
+            "currency_code": "USD"
+          }
+        },
+        "line_item": {
+          "id": 487817672276298560,
+          "variant_id": null,
+          "title": "Aviator sunglasses",
+          "quantity": 1,
+          "sku": "SKU2006-001",
+          "variant_title": null,
+          "vendor": null,
+          "fulfillment_service": "manual",
+          "product_id": 788032119674292900,
+          "requires_shipping": true,
+          "taxable": true,
+          "gift_card": false,
+          "name": "Aviator sunglasses",
+          "variant_inventory_management": null,
+          "properties": [],
+          "product_exists": true,
+          "fulfillable_quantity": 1,
+          "grams": 100,
+          "price": "89.99",
+          "total_discount": "0.00",
+          "fulfillment_status": null,
+          "price_set": {
+            "shop_money": {
+              "amount": "89.99",
+              "currency_code": "USD"
+            },
+            "presentment_money": {
+              "amount": "89.99",
+              "currency_code": "USD"
+            }
+          },
+          "total_discount_set": {
+            "shop_money": {
+              "amount": "0.00",
+              "currency_code": "USD"
+            },
+            "presentment_money": {
+              "amount": "0.00",
+              "currency_code": "USD"
+            }
+          },
+          "discount_allocations": [],
+          "duties": [],
+          "admin_graphql_api_id": "gid://shopify/LineItem/487817672276298554",
+          "tax_lines": []
+        }
+      },
+      {
+        "id": 789012345678901200,
+        "quantity": 1,
+        "line_item_id": 789012345678901200,
+        "location_id": null,
+        "restock_type": "no_restock",
+        "subtotal": 19.99,
+        "total_tax": 0,
+        "subtotal_set": {
+          "shop_money": {
+            "amount": "19.99",
+            "currency_code": "USD"
+          },
+          "presentment_money": {
+            "amount": "19.99",
+            "currency_code": "USD"
+          }
+        },
+        "total_tax_set": {
+          "shop_money": {
+            "amount": "0.00",
+            "currency_code": "USD"
+          },
+          "presentment_money": {
+            "amount": "0.00",
+            "currency_code": "USD"
+          }
+        },
+        "line_item": {
+          "id": 789012345678901200,
+          "variant_id": null,
+          "title": "Lens Protection Plan (2 Year)",
+          "quantity": 1,
+          "sku": "LENS-PROTECT-2YR",
+          "variant_title": null,
+          "vendor": null,
+          "fulfillment_service": "manual",
+          "product_id": null,
+          "requires_shipping": true,
+          "taxable": true,
+          "gift_card": false,
+          "name": "Lens Protection Plan (2 Year)",
+          "variant_inventory_management": null,
+          "properties": [],
+          "product_exists": false,
+          "fulfillable_quantity": 1,
+          "grams": 0,
+          "price": "19.99",
+          "total_discount": "0.00",
+          "fulfillment_status": null,
+          "price_set": {
+            "shop_money": {
+              "amount": "19.99",
+              "currency_code": "USD"
+            },
+            "presentment_money": {
+              "amount": "19.99",
+              "currency_code": "USD"
+            }
+          },
+          "total_discount_set": {
+            "shop_money": {
+              "amount": "0.00",
+              "currency_code": "USD"
+            },
+            "presentment_money": {
+              "amount": "0.00",
+              "currency_code": "USD"
+            }
+          },
+          "discount_allocations": [],
+          "duties": [],
+          "admin_graphql_api_id": "gid://shopify/LineItem/789012345678901234",
+          "tax_lines": []
+        }
+      },
+      {
+        "id": 890123456789012500,
+        "quantity": 1,
+        "line_item_id": 890123456789012400,
+        "location_id": null,
+        "restock_type": "no_restock",
+        "subtotal": 24.99,
+        "total_tax": 0,
+        "subtotal_set": {
+          "shop_money": {
+            "amount": "24.99",
+            "currency_code": "USD"
+          },
+          "presentment_money": {
+            "amount": "24.99",
+            "currency_code": "USD"
+          }
+        },
+        "total_tax_set": {
+          "shop_money": {
+            "amount": "0.00",
+            "currency_code": "USD"
+          },
+          "presentment_money": {
+            "amount": "0.00",
+            "currency_code": "USD"
+          }
+        },
+        "line_item": {
+          "id": 890123456789012400,
+          "variant_id": null,
+          "title": "Premium Leather Case",
+          "quantity": 1,
+          "sku": "CASE-LEATHER-PREM",
+          "variant_title": null,
+          "vendor": null,
+          "fulfillment_service": "manual",
+          "product_id": null,
+          "requires_shipping": true,
+          "taxable": true,
+          "gift_card": false,
+          "name": "Premium Leather Case",
+          "variant_inventory_management": null,
+          "properties": [],
+          "product_exists": false,
+          "fulfillable_quantity": 1,
+          "grams": 0,
+          "price": "24.99",
+          "total_discount": "0.00",
+          "fulfillment_status": null,
+          "price_set": {
+            "shop_money": {
+              "amount": "24.99",
+              "currency_code": "USD"
+            },
+            "presentment_money": {
+              "amount": "24.99",
+              "currency_code": "USD"
+            }
+          },
+          "total_discount_set": {
+            "shop_money": {
+              "amount": "0.00",
+              "currency_code": "USD"
+            },
+            "presentment_money": {
+              "amount": "0.00",
+              "currency_code": "USD"
+            }
+          },
+          "discount_allocations": [],
+          "duties": [],
+          "admin_graphql_api_id": "gid://shopify/LineItem/890123456789012345",
+          "tax_lines": []
+        }
+      },
+      {
+        "id": 976318377106520400,
+        "quantity": 1,
+        "line_item_id": 976318377106520300,
+        "location_id": null,
+        "restock_type": "no_restock",
+        "subtotal": 159.99,
+        "total_tax": 0,
+        "subtotal_set": {
+          "shop_money": {
+            "amount": "159.99",
+            "currency_code": "USD"
+          },
+          "presentment_money": {
+            "amount": "159.99",
+            "currency_code": "USD"
+          }
+        },
+        "total_tax_set": {
+          "shop_money": {
+            "amount": "0.00",
+            "currency_code": "USD"
+          },
+          "presentment_money": {
+            "amount": "0.00",
+            "currency_code": "USD"
+          }
+        },
+        "line_item": {
+          "id": 976318377106520300,
+          "variant_id": null,
+          "title": "Mid-century lounger",
+          "quantity": 1,
+          "sku": "SKU2006-020",
+          "variant_title": null,
+          "vendor": null,
+          "fulfillment_service": "manual",
+          "product_id": 788032119674292900,
+          "requires_shipping": true,
+          "taxable": true,
+          "gift_card": false,
+          "name": "Mid-century lounger",
+          "variant_inventory_management": null,
+          "properties": [],
+          "product_exists": true,
+          "fulfillable_quantity": 1,
+          "grams": 1000,
+          "price": "159.99",
+          "total_discount": "5.00",
+          "fulfillment_status": null,
+          "price_set": {
+            "shop_money": {
+              "amount": "159.99",
+              "currency_code": "USD"
+            },
+            "presentment_money": {
+              "amount": "159.99",
+              "currency_code": "USD"
+            }
+          },
+          "total_discount_set": {
+            "shop_money": {
+              "amount": "5.00",
+              "currency_code": "USD"
+            },
+            "presentment_money": {
+              "amount": "5.00",
+              "currency_code": "USD"
+            }
+          },
+          "discount_allocations": [
+            {
+              "amount": "5.00",
+              "discount_application_index": 0,
+              "amount_set": {
+                "shop_money": {
+                  "amount": "5.00",
+                  "currency_code": "USD"
+                },
+                "presentment_money": {
+                  "amount": "5.00",
+                  "currency_code": "USD"
+                }
+              }
+            },
+            {
+              "amount": "5.00",
+              "discount_application_index": 2,
+              "amount_set": {
+                "shop_money": {
+                  "amount": "5.00",
+                  "currency_code": "USD"
+                },
+                "presentment_money": {
+                  "amount": "5.00",
+                  "currency_code": "USD"
+                }
+              }
+            }
+          ],
+          "duties": [],
+          "admin_graphql_api_id": "gid://shopify/LineItem/976318377106520349",
+          "tax_lines": []
+        }
+      },
+      {
+        "id": 315789986012684500,
+        "quantity": 1,
+        "line_item_id": 315789986012684400,
+        "location_id": null,
+        "restock_type": "no_restock",
+        "subtotal": 119.99,
+        "total_tax": 0,
+        "subtotal_set": {
+          "shop_money": {
+            "amount": "119.99",
+            "currency_code": "USD"
+          },
+          "presentment_money": {
+            "amount": "119.99",
+            "currency_code": "USD"
+          }
+        },
+        "total_tax_set": {
+          "shop_money": {
+            "amount": "0.00",
+            "currency_code": "USD"
+          },
+          "presentment_money": {
+            "amount": "0.00",
+            "currency_code": "USD"
+          }
+        },
+        "line_item": {
+          "id": 315789986012684400,
+          "variant_id": null,
+          "title": "Coffee table",
+          "quantity": 1,
+          "sku": "SKU2006-035",
+          "variant_title": null,
+          "vendor": null,
+          "fulfillment_service": "manual",
+          "product_id": 788032119674292900,
+          "requires_shipping": true,
+          "taxable": true,
+          "gift_card": false,
+          "name": "Coffee table",
+          "variant_inventory_management": null,
+          "properties": [],
+          "product_exists": true,
+          "fulfillable_quantity": 1,
+          "grams": 500,
+          "price": "119.99",
+          "total_discount": "0.00",
+          "fulfillment_status": null,
+          "price_set": {
+            "shop_money": {
+              "amount": "119.99",
+              "currency_code": "USD"
+            },
+            "presentment_money": {
+              "amount": "119.99",
+              "currency_code": "USD"
+            }
+          },
+          "total_discount_set": {
+            "shop_money": {
+              "amount": "0.00",
+              "currency_code": "USD"
+            },
+            "presentment_money": {
+              "amount": "0.00",
+              "currency_code": "USD"
+            }
+          },
+          "discount_allocations": [],
+          "duties": [],
+          "admin_graphql_api_id": "gid://shopify/LineItem/315789986012684393",
+          "tax_lines": []
+        }
+      }
+    ],
+    "transactions": [
+      {
+        "id": 245135271310201180,
+        "order_id": 820982911946154500,
+        "kind": "refund",
+        "gateway": "bogus",
+        "status": "success",
+        "message": "This is a refund",
+        "created_at": "2019-12-31T19:00:00-05:00",
+        "test": false,
+        "authorization": null,
+        "location_id": null,
+        "user_id": null,
+        "parent_id": null,
+        "processed_at": null,
+        "device_id": null,
+        "error_code": null,
+        "source_name": "web",
+        "receipt": {},
+        "amount": "75.00",
+        "currency": null,
+        "payment_id": "#9999.",
+        "total_unsettled_set": {
+          "presentment_money": {
+            "amount": "0.0",
+            "currency": "XXX"
+          },
+          "shop_money": {
+            "amount": "0.0",
+            "currency": "XXX"
+          }
+        },
+        "manual_payment_gateway": false,
+        "amount_rounding": null,
+        "admin_graphql_api_id": "gid://shopify/OrderTransaction/245135271310201194"
+      },
+      {
+        "id": 839212141605670500,
+        "order_id": 820982911946154500,
+        "kind": "refund",
+        "gateway": "bogus",
+        "status": "success",
+        "message": null,
+        "created_at": "2020-01-01T19:00:00-05:00",
+        "test": false,
+        "authorization": null,
+        "location_id": null,
+        "user_id": null,
+        "parent_id": null,
+        "processed_at": null,
+        "device_id": null,
+        "error_code": null,
+        "source_name": "web",
+        "receipt": {},
+        "amount": "10.00",
+        "currency": null,
+        "payment_id": "#9999.",
+        "total_unsettled_set": {
+          "presentment_money": {
+            "amount": "0.0",
+            "currency": "XXX"
+          },
+          "shop_money": {
+            "amount": "0.0",
+            "currency": "XXX"
+          }
+        },
+        "manual_payment_gateway": false,
+        "amount_rounding": null,
+        "admin_graphql_api_id": "gid://shopify/OrderTransaction/839212141605670573"
+      }
+    ]
+  },
+  "shop_feature": false
+}

package/metadatas/2026-01/returns/approve.json

@@ -0,0 +1,52 @@
+{
+  "access_scopes": [
+    "returns",
+    "marketplace_returns",
+    "buyer_membership_orders"
+  ],
+  "available_on": [
+    "graphql",
+    "toml"
+  ],
+  "deprecated": false,
+  "description": "Occurs whenever a return is approved. This means `Return.status` is `OPEN`.",
+  "name": "returns/approve",
+  "related_resource": "Return",
+  "response": {
+    "id": 123134564567890,
+    "admin_graphql_api_id": "gid://shopify/Return/123134564567890",
+    "status": "open",
+    "order": {
+      "id": 4783296544821,
+      "admin_graphql_api_id": "gid://shopify/Order/4783296544821"
+    },
+    "total_return_line_items": 2,
+    "name": null,
+    "return_line_items": [],
+    "return_shipping_fees": [
+      {
+        "id": 987654321547866,
+        "admin_graphql_api_id": "gid://shopify/ReturnShippingFee/987654321547866",
+        "price": {
+          "shop_money": {
+            "amount": "10.0",
+            "currency_code": "XXX"
+          },
+          "presentment_money": {
+            "amount": "10.0",
+            "currency_code": "XXX"
+          }
+        }
+      }
+    ],
+    "exchange_line_items": [
+      {
+        "id": 987654321283476,
+        "admin_graphql_api_id": "gid://shopify/ExchangeLineItem/987654321283476",
+        "line_item": null
+      }
+    ],
+    "total_exchange_line_items": 1
+  },
+  "shop_feature": false
+}

package/metadatas/2026-01/returns/cancel.json

@@ -0,0 +1,24 @@
+{
+  "access_scopes": [
+    "orders",
+    "marketplace_orders",
+    "returns",
+    "marketplace_returns",
+    "buyer_membership_orders"
+  ],
+  "available_on": [
+    "graphql",
+    "toml"
+  ],
+  "deprecated": false,
+  "description": "Occurs whenever a return is canceled.",
+  "name": "returns/cancel",
+  "related_resource": "Return",
+  "response": {
+    "id": 123134564567890,
+    "admin_graphql_api_id": "gid://shopify/Return/123134564567890",
+    "order_id": 4783296544821,
+    "status": "canceled"
+  },
+  "shop_feature": false
+}

package/metadatas/2026-01/returns/close.json

@@ -0,0 +1,24 @@
+{
+  "access_scopes": [
+    "orders",
+    "marketplace_orders",
+    "returns",
+    "marketplace_returns",
+    "buyer_membership_orders"
+  ],
+  "available_on": [
+    "graphql",
+    "toml"
+  ],
+  "deprecated": false,
+  "description": "Occurs whenever a return is closed.",
+  "name": "returns/close",
+  "related_resource": "Return",
+  "response": {
+    "id": 123134564567890,
+    "admin_graphql_api_id": "gid://shopify/Return/123134564567890",
+    "order_id": 4783296544821,
+    "status": "closed"
+  },
+  "shop_feature": false
+}

package/metadatas/2026-01/returns/decline.json

@@ -0,0 +1,29 @@
+{
+  "access_scopes": [
+    "returns",
+    "marketplace_returns",
+    "buyer_membership_orders"
+  ],
+  "available_on": [
+    "graphql",
+    "toml"
+  ],
+  "deprecated": false,
+  "description": "Occurs whenever a return is declined. This means `Return.status` is `DECLINED`.",
+  "name": "returns/decline",
+  "related_resource": "Return",
+  "response": {
+    "id": 123134564567890,
+    "admin_graphql_api_id": "gid://shopify/Return/123134564567890",
+    "status": "declined",
+    "order": {
+      "id": 4783296544821,
+      "admin_graphql_api_id": "gid://shopify/Order/4783296544821"
+    },
+    "decline": {
+      "reason": "return_period_ended",
+      "note": "As discussed on the phone, the 30-day return window has ended."
+    }
+  },
+  "shop_feature": false
+}

package/metadatas/2026-01/returns/reopen.json

@@ -0,0 +1,24 @@
+{
+  "access_scopes": [
+    "orders",
+    "marketplace_orders",
+    "returns",
+    "marketplace_returns",
+    "buyer_membership_orders"
+  ],
+  "available_on": [
+    "graphql",
+    "toml"
+  ],
+  "deprecated": false,
+  "description": "Occurs whenever a closed return is reopened.",
+  "name": "returns/reopen",
+  "related_resource": "Return",
+  "response": {
+    "id": 123134564567890,
+    "admin_graphql_api_id": "gid://shopify/Return/123134564567890",
+    "order_id": 4783296544821,
+    "status": "open"
+  },
+  "shop_feature": false
+}