---
title: UserErrorsShopPayPaymentRequestSessionUserErrors - Storefront API
description: Error codes for failed Shop Pay payment request session mutations.
api_version: 2026-07
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/objects/UserErrorsShopPayPaymentRequestSessionUserErrors
  md: >-
    https://shopify.dev/docs/api/storefront/latest/objects/UserErrorsShopPayPaymentRequestSessionUserErrors.md
api_name: storefront
api_type: graphql
type: object
---

# User​Errors​Shop​Pay​Payment​Request​Session​User​Errors

object

Error codes for failed Shop Pay payment request session mutations.

## Fields

* code

  [User​Errors​Shop​Pay​Payment​Request​Session​User​Errors​Code](https://shopify.dev/docs/api/storefront/latest/enums/UserErrorsShopPayPaymentRequestSessionUserErrorsCode)

  The error code.

* field

  [\[String!\]](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  The path to the input field that caused the error.

* message

  [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

  non-null

  The error message.

***

## Map

No referencing types

***

## Mutations

* [shop​Pay​Payment​Request​Session​Create](https://shopify.dev/docs/api/storefront/latest/mutations/shopPayPaymentRequestSessionCreate)

  mutation

  Creates a [Shop Pay payment request session](https://shopify.dev/docs/api/storefront/2026-07/objects/ShopPayPaymentRequestSession) for processing payments. The session includes a checkout URL where customers complete their purchase and a token for subsequent operations like submitting the payment.

  The `sourceIdentifier` must be unique across all orders to ensure accurate reconciliation.

  For a complete integration guide including the JavaScript SDK setup and checkout flow, refer to the [Shop Component API documentation](https://shopify.dev/docs/api/commerce-components/pay). For implementation steps, see the [development journey guide](https://shopify.dev/docs/api/commerce-components/pay/development-journey). For common error scenarios, see the [troubleshooting guide](https://shopify.dev/docs/api/commerce-components/pay/troubleshooting-guide).

  * payment​Request

    [Shop​Pay​Payment​Request​Input!](https://shopify.dev/docs/api/storefront/latest/input-objects/ShopPayPaymentRequestInput)

    required

    ### Arguments

    A payment request object.

  * source​Identifier

    [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

    required

    A unique identifier for the payment request session.

  ***

* [shop​Pay​Payment​Request​Session​Submit](https://shopify.dev/docs/api/storefront/latest/mutations/shopPayPaymentRequestSessionSubmit)

  mutation

  Finalizes a [Shop Pay payment request session](https://shopify.dev/docs/api/storefront/2026-07/objects/ShopPayPaymentRequestSession). Call this mutation after creating a session with [`shopPayPaymentRequestSessionCreate`](https://shopify.dev/docs/api/storefront/2026-07/mutations/shopPayPaymentRequestSessionCreate).

  The [`idempotencyKey`](https://shopify.dev/docs/api/storefront/2026-07/mutations/shopPayPaymentRequestSessionSubmit#arguments-idempotencyKey) argument ensures the payment transaction occurs only once, preventing duplicate charges. On success, returns a [`ShopPayPaymentRequestReceipt`](https://shopify.dev/docs/api/storefront/2026-07/objects/ShopPayPaymentRequestReceipt) with the processing status and a receipt token.

  For a complete integration guide including the JavaScript SDK setup and checkout flow, refer to the [Shop Component API documentation](https://shopify.dev/docs/api/commerce-components/pay). For implementation steps, see the [development journey guide](https://shopify.dev/docs/api/commerce-components/pay/development-journey). For common error scenarios, see the [troubleshooting guide](https://shopify.dev/docs/api/commerce-components/pay/troubleshooting-guide).

  * idempotency​Key

    [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

    required

    ### Arguments

    The idempotency key is used to guarantee an idempotent result.

  * order​Name

    [String](https://shopify.dev/docs/api/storefront/latest/scalars/String)

    The order name to be used for the order created from the payment request.

  * payment​Request

    [Shop​Pay​Payment​Request​Input!](https://shopify.dev/docs/api/storefront/latest/input-objects/ShopPayPaymentRequestInput)

    required

    The final payment request object.

  * token

    [String!](https://shopify.dev/docs/api/storefront/latest/scalars/String)

    required

    A token representing a payment session request.

  ***

***

## UserErrorsShopPayPaymentRequestSessionUserErrors Mutations

### Mutated by

* [shop​Pay​Payment​Request​Session​Create](https://shopify.dev/docs/api/storefront/latest/mutations/shopPayPaymentRequestSessionCreate)
* [shop​Pay​Payment​Request​Session​Submit](https://shopify.dev/docs/api/storefront/latest/mutations/shopPayPaymentRequestSessionSubmit)

***

## Interfaces

* [Displayable​Error](https://shopify.dev/docs/api/storefront/latest/interfaces/DisplayableError)

  interface

***

## UserErrorsShopPayPaymentRequestSessionUserErrors Implements

### Implements

* [Displayable​Error](https://shopify.dev/docs/api/storefront/latest/interfaces/DisplayableError)