Field 'paymentsAppConfigure' doesn't exist on type 'Mutation'

Retired Boards Appdev Graphql Basics And Troubleshooting
,

Topic summary

A developer is encountering a GraphQL error while building a Shopify payment app with an external payments extension.

The Core Issue:

  • Error message: “Field ‘paymentsAppConfigure’ doesn’t exist on type ‘Mutation’”
  • Occurs when attempting to use the paymentsAppConfigure mutation during the activation/confirmation step after app installation
  • The app has the write_payment_gateways scope configured

Developer’s Questions:

  • Is the implementation approach incorrect?
  • Should a different path be followed?
  • What additional steps are needed?
  • The developer notes they already have an approved Shopify account

Context:
The developer is following Shopify’s official documentation for onboarding merchants with payment extensions, specifically Step 3 regarding provider authorization and configuration. The discussion remains open with no resolution provided yet.

Summarized with AI on November 6. AI used: claude-sonnet-4-5-20250929.
1

I am developing a payment app by adding a new provider. I am using an external payments extension. When I install the app, it asks to activate and requires confirmation.

Following this documentation:
https://shopify.dev/docs/apps/build/payments/onboard-a-merchant-payments-extension#step-3-complete-provider-authorization-and-configuration

and using the ‘paymentsAppConfigure’ mutator, I get the following response:

Field ‘paymentsAppConfigure’ doesn’t exist on type ‘Mutation’

even though the scope is ‘write_payment_gateways’.
Am I doing it the wrong way? What needs to be done?
I already have the account approved by Shopify.
Should I follow a different path?