Upcoming API updates for Apple Pay and Shop Pay support for subscriptions.

Shopify Staff (Retired)
66 6 8

We have added a new CustomerPaymentInstrument subtype named CustomerShopPayAgreement to the 2021-10 API version that allows the ability to store Shop Pay Agreements in Shopify to be used by SubscriptionContracts. A new source field on the CustomerCreditCard instrument allows the ability to query the source of the customer's credit card (for example, Apple Pay).

We also introduced a `
customerPaymentMethodGetUpdateUrl` mutation to the Admin API that, given a customer payment method ID, returns a URL that enables a customer to update their payment method in a secure way when in a session. This mutation supports Shop Pay as of mid October 2021, and will expand support to other payment methods in the future. The `customerPaymentMethodSendUpdateEmail` is recommended as a fallback when the `customerPaymentMethodGetUpdateUrl` returns an error or when the customer needs to update their payment method outside of a session. 

The new payment method instrument might be a breaking change depending how your GraphQL queries are written and how your code handles unknown instrument types.

We encourage everyone to audit your code at the earliest convenience to ensure your application continues to function after the planned roll out mid October.

To learn more visit the Shopify Help Center or the Community Blog.

Replies 4 (4)

8 2 6

Dear @J-ROM ,

Is there a chance that recent updates in payment methods could lead to this problem: https://community.shopify.com/c/shopify-apis-and-sdks/stripe-payment-method-from-customerpaymentmeth... ?

Shopify Partner
4 0 0

Hey @J-ROM,  does this mean there's finally possible for accelerated checkout  of subscription products w/ ShopPay?

It's unclear in the documentation whether this means customers can finally checkout w/ ShopPay for orders w/ subscription items.

Shopify Staff (Retired)
66 6 8


You are correct: customers will be able to use Shop Pay or Apple Pay to purchase subscription products (when merchants have enabled these payment options on their stores). Roll out should start early November.


To learn more visit the Shopify Help Center or the Community Blog.