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.
