---
title: PaymentsAppConfigurePayload - Payments Apps API
description: Return type for `paymentsAppConfigure` mutation.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/payments-apps/latest/payloads/PaymentsAppConfigurePayload
  md: >-
    https://shopify.dev/docs/api/payments-apps/latest/payloads/PaymentsAppConfigurePayload.md
api_name: payments-apps
api_type: graphql
type: payload
---

# Payments​App​Configure​Payload

payload

Return type for `paymentsAppConfigure` mutation.

## Fields

* payments​App​Configuration

  [Payments​App​Configuration](https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentsAppConfiguration)

  The production configuration of the payments app.

* user​Errors

  [\[User​Error!\]!](https://shopify.dev/docs/api/payments-apps/latest/objects/UserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Mutations with this payload

* [payments​App​Configure](https://shopify.dev/docs/api/payments-apps/latest/mutations/paymentsAppConfigure)

  mutation

  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).

  * external​Handle

    [String](https://shopify.dev/docs/api/payments-apps/latest/scalars/String)

    ### Arguments

    Handle used in the external system.

  * ready

    [Boolean!](https://shopify.dev/docs/api/payments-apps/latest/scalars/Boolean)

    required

    The provider is ready to process merchant's payments.

  ***

***

## Map

### Mutations with this payload

* [payments​App​Configure](https://shopify.dev/docs/api/payments-apps/latest/mutations/paymentsAppConfigure)