Order write‑offs, Shop Pay config, and enum expansion

11/19/2026, 12:00:38 AM

The unstable API now exposes a query to retrieve a shop’s Shop Pay payment‑request configuration, providing the public client ID and allowed origins. New types for order write‑offs (OrderWriteOff, OrderWriteOffConnection, OrderWriteOffEdge, OrderWriteOffKind, OrderWriteOffStatus, OrderWriteOffSortKeys) enable querying, creating, and paginating write‑offs attached to an order via the added writeOffs field. Usage limits on discount code objects now clarify that the value counts across all customers, improving documentation consistency. The InventoryShipmentAddItemsUserErrorCode enum gains a BUNDLED_ITEM value, and StaffMemberPermission and WebhookSubscriptionTopic enums receive new members (MANAGE_INVENTORY_BINS, SUPPLIER_ACCOUNTS_CREATE). The inventoryCountCreate mutation’s description no longer references preview content, signaling its availability to all unstable API users. These changes provide merchants with richer order financial controls, easier Shop Pay integration, and clearer permission and event handling options.

Query Changes

➕ Added Queries (1)

shopPayPaymentRequestConfiguration

Returns the shop's Shop Pay payment request configuration: the client ID that the Shop Pay JavaScript SDK takes as clientId, and the origins where Shop Pay can run. Returns null when the shop isn't set up for the Shop Pay Commerce Component.

Mutation Changes

🔄 Modified Mutations (1)

inventoryCountCreate

Creates an inventory count for auditing and adjusting stock levels at a specific location.

Type Changes

➕ Added Types (7)

🏗️OrderWriteOff➕ AddedOBJECT

An amount of an order's outstanding balance that the merchant has chosen not to collect.

Fields: createdAt, currentAmountSet, id, kind, reason ... +1 more
🏗️OrderWriteOffConnection➕ AddedOBJECT

An auto-generated type for paginating through multiple OrderWriteOffs.

Fields: edges, nodes, pageInfo
🏗️OrderWriteOffEdge➕ AddedOBJECT

An auto-generated type which holds one OrderWriteOff and a cursor during pagination.

Fields: cursor, node
📋OrderWriteOffKind➕ AddedENUM

The accounting classification of a write-off. Total written-off amounts include all kinds, including UNKNOWN.

Values: WAIVED, UNKNOWN
📋OrderWriteOffSortKeys➕ AddedENUM

The set of valid sort keys for the OrderWriteOff query.

Values: CREATED_AT
📋OrderWriteOffStatus➕ AddedENUM

The status of write-offs to include in an order's write-off list.

Values: ACTIVE, REVERSED, ALL
🏗️ShopPayPaymentRequestConfiguration➕ AddedOBJECT

The shop's Shop Pay payment request settings.

Fields: allowedOrigins, clientId

🔄 Modified Types (8)

🏗️DiscountCodeApp🔄 Modified
🔄 Field modified: usageLimit
🏗️DiscountCodeBasic🔄 Modified
🔄 Field modified: usageLimit
🏗️DiscountCodeBxgy🔄 Modified
🔄 Field modified: usageLimit
🏗️DiscountCodeFreeShipping🔄 Modified
🔄 Field modified: usageLimit
🏗️InventoryShipmentAddItemsUserErrorCode🔄 Modified
➕ Enum value added: BUNDLED_ITEM
🏗️Order🔄 Modified
➕ Field added: writeOffs

A list of write-offs associated with the order.

🏗️StaffMemberPermission🔄 Modified
➕ Enum value added: MANAGE_INVENTORY_BINS
🏗️WebhookSubscriptionTopic🔄 Modified
➕ Enum value added: SUPPLIER_ACCOUNTS_CREATE