9/26/2026, 12:00:32 AM
The Rollouts query now accepts a new "change_type" filter, and the query description was updated to reflect this addition. Rollout objects gained granularity with new "createdAt", "updatedAt", "effectiveTrafficAllocation" and "trafficAllocation" fields, and the legacy timestamps "creationDate" and "lastEditDate" were removed. An interface, HasRollouts, was introduced so that types such as discounts can expose their rollout lifecycle via a ‘rollouts’ connection, with refined status filtering in all related rollouts fields. The RolloutTreatment type was cleaned up: its "changes" field description was tightened and its "split" labeling clarified as a 0‑100 percent band. Additional enhancements include the CardPresentPaymentDetails last4 field, linkedCollections on collection sources, the new XCG currency code, two error-code enum additions, and a businessEntity field on ShopPayPaymentRequestReceipt. Finally, new webhook topics (ROLLOUTS_CREATE, ROLLOUTS_DELETE, ROLLOUTS_UPDATE, and resource change events) enable real‑time rollout monitoring.
Returns the list of rollouts in the shop.
A resource that can be included in rollouts. Use this interface to query the
resource's rollouts with a reusable fragment.
last4Last four digits of the payment card.
linkedCollectionsThe collections that use this source, ordered by collection ID.
For sub-collection sources, these are the owning collections, not the referenced sub-collections.
linkedCollectionsThe collections that use this source, ordered by collection ID.
For sub-collection sources, these are the owning collections, not the referenced sub-collections.
linkedCollectionsThe collections that use this source, ordered by collection ID.
For sub-collection sources, these are the owning collections, not the referenced sub-collections.
XCGrolloutsrolloutsrolloutsrolloutsrolloutsrolloutsrolloutsrolloutsUNTRACKED_ITEMSUBDIVISION_MARKET_REQUIRES_COUNTRY_COVERAGEcreationDatelastEditDaterolloutTrafficAllocationcreatedAtThe date and time at which the rollout was created.
effectiveTrafficAllocationThe effective percentage of total traffic this rollout receives for new buyer assignments, accounting for mutex group constraints with other active rollouts.
trafficAllocationThe percentage of buyer traffic that the rollout is configured to receive, as an integer from 0 to 100. This is the configured allocation before other active rollouts on the same resources are taken into account, so it isn't the share of buyers that a treatment reaches.
updatedAtThe date and time at which the rollout was last edited. This timestamp doesn't necessarily change when another rollout changes this rollout's effective traffic allocation.
changessplitbusinessEntityThe business entity recorded when the payment request was submitted, including archived entities. Returns null if no entity was recorded or the recorded entity cannot be found for this shop.
ROLLOUTS_CREATEROLLOUTS_DELETEROLLOUTS_RESOURCE_CHANGE_ADDEDROLLOUTS_RESOURCE_CHANGE_REMOVEDROLLOUTS_RESOURCE_CHANGE_UPDATEDROLLOUTS_UPDATE