Payment method identifier now required for customerPaymentMethodRemoteCreate
Shopify developer change
MerchantDiff detected this entry in Shopify's official developer changelog on April 01, 2026.
This Shopify update is categorized as API, Breaking API Change, Admin GraphQL API, 2026-07.
What changed
As of API version 2026-07, the payment method identifier field is now required when using the customerPaymentMethodRemoteCreate mutation with Stripe, Authorize.net, or Braintree inputs. The affected fields are: paymentMethodId on RemoteStripePaymentMethodInput customerPaymentProfileId on RemoteAuthorizeNetCustomerPaymentProfileInput paymentMethodToken on RemoteBraintreePaymentMethodInput These fields were previously optional at the schema level but are required for the payment method to be functional. Without a payment method identifier, remotely created payment methods cannot be used for payment processing. This change aligns the API schema with existing runtime requirements. If you are already passing a payment method identifier when calling this mutation, no changes are needed.
Who is affected
Apps using the affected Shopify GraphQL API surface should review this change.
What action may be needed
Review the official Shopify entry and test the affected integration. Apply any required code or configuration changes before deploying.
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 →