1/24/2026, 12:00:55 AM
Shopify’s GraphQL API now supports a comprehensive delivery method rate system, introducing DeliveryRateGroup and associated connection/edge types to represent grouped rates. DeliveryMethodDefinition now exposes currencyCode, freeConditions, and a rateGroups list, while DeliveryRateDefinition gains conditions, maxTransitTime, and minTransitTime fields. New enumerations and connection types enable paginated access to delivery rate range conditions and weight/value rules. Subscription billing attempts have been refactored: legacy fields errorCode, errorMessage, nextActionUrl, order, processingError, and ready are deprecated in favor of a new non‑nullable state union that aggregates ActionRequiredState, FailedState, PendingState, and SuccessState. Associated error code enums (General, Inventory, Payment) and the InventoryShipmentCreateInTransitUserErrorCode now include SHIPMENT_NOT_FOUND. The OrderTransaction receiptJson description emphasizes that it is gateway‑specific, discouraging apps from relying on it for business logic.
A group of rates that make up a method definition.
An auto-generated type for paginating through multiple DeliveryRateGroups.
An auto-generated type which holds one DeliveryRateGroup and a cursor during pagination.
An auto-generated type for paginating through multiple DeliveryRateProviders.
An auto-generated type which holds one DeliveryRateProvider and a cursor during pagination.
The rate range condition for a conditionable object.
The value (weight or price) that the condition field is compared to.
The subject of the rate range condition.
The action required to continue processing the billing attempt.
The billing attempt state that requires an action to resolve.
Must complete the action required for the billing attempt to continue being processed.
Possible error types for a subscription billing attempt.
The billing attempt failed due to an error.
An error that occurred during a subscription billing attempt that doesn't fit other categories.
Error codes for other billing attempt failures.
An inventory-related error that occurred during a subscription billing attempt.
Error codes for inventory-related billing attempt failures.
A payment challenge that the customer must complete.
The status of the billing attempt authentication process.
A payment-related error that occurred during a subscription billing attempt.
Error codes for payment-related billing attempt failures.
The billing attempt is currently being processed.
The state of a subscription billing attempt with state-specific data.
The billing attempt completed successfully and created an order.
addressescurrencyCodeThe currency used in this method definition.
freeConditionsThe conditions that must pass for free delivery to be applied to an order.
rateGroupsThe rate groups that make up this method definition.
conditionsThe conditions that must pass for this rate definition to be applied to an order.
maxTransitTimeThe maximum transit time of the rate in seconds.
minTransitTimeThe minimum transit time of the rate in seconds.
SHIPMENT_NOT_FOUNDreceiptJsonerrorCodeerrorMessagenextActionUrlorderprocessingErrorreadystateThe state of the billing attempt with state-specific data.