# paymentsAppConfigure - payments-apps - MUTATION
Version: 2024-10

## Description
Configures the partner-managed payments gateway to work on the merchant's store. For an example of how to use the `paymentsAppConfigure` mutation, refer to the tutorial for [onboarding merchants to payments extensions](https://shopify.dev/docs/apps/build/payments/onboard-a-merchant-payments-extension).

### Access Scopes
`write_payment_gateways` access scope.


## Arguments
* [externalHandle](/docs/api/payments-apps/2024-10/scalars/String): String - Handle used in the external system.
* [ready](/docs/api/payments-apps/2024-10/scalars/Boolean): Boolean! - The provider is ready to process merchant's payments.


## Returns
* [paymentsAppConfiguration](/docs/api/payments-apps/2024-10/objects/PaymentsAppConfiguration): PaymentsAppConfiguration The production configuration of the payments app.
* [userErrors](/docs/api/payments-apps/2024-10/objects/UserError): UserError! The list of errors that occurred from executing the mutation.


## Examples