Payment mandates now expose an id field
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on June 27, 2026.
This Shopify update is categorized as API, New, Admin GraphQL API, 2026-07.
What changed
In API version 2026-07 and later, the PaymentMandateResource object includes a new id field. PaymentMandateResource is returned by the mandates connection on CustomerPaymentMethod. Its id is the same as the corresponding CustomerPaymentMethod.id, which lets you determine which payment method to use for a given mandate scope (for example, the SUBSCRIPTIONS scope) when a single payment instrument is associated with multiple mandate types.
Who is affected
Apps using the affected Shopify GraphQL API surface should review this change.
What action may be needed
Review whether the new capability is relevant to your app. If you plan to use it, test the affected API or workflow before adopting it in production.
Use the official Shopify entry below as the source of truth for technical implementation details, affected APIs, migration instructions and deadlines.
Want the actionable version?
MerchantDiff monitors Shopify API changes, deprecations, deadlines and ecosystem updates, then turns them into developer-focused release intelligence: what changed, who is affected and what action may be needed.
Get MerchantDiff →