---
title: shopPayPaymentRequestSessionCreate - Storefront API
description: >
  Creates a [Shop Pay payment request
  session](/docs/api/storefront/2026-04/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).
api_version: 2026-04
api_name: storefront
type: mutation
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/mutations/shopPayPaymentRequestSessionCreate
  md: >-
    https://shopify.dev/docs/api/storefront/latest/mutations/shopPayPaymentRequestSessionCreate.md
---

# shop​Pay​Payment​Request​Session​Create

mutation

Creates a [Shop Pay payment request session](https://shopify.dev/docs/api/storefront/2026-04/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).

## Arguments

* payment​Request

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

  required

  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​Create​Payload returns

* shop​Pay​Payment​Request​Session

  [Shop​Pay​Payment​Request​Session](https://shopify.dev/docs/api/storefront/latest/objects/ShopPayPaymentRequestSession)

  The new Shop Pay payment request session object.

* user​Errors

  [\[User​Errors​Shop​Pay​Payment​Request​Session​User​Errors!\]!](https://shopify.dev/docs/api/storefront/latest/objects/UserErrorsShopPayPaymentRequestSessionUserErrors)

  non-null

  Error codes for failed Shop Pay payment request session mutations.

***

## Examples

* ### shopPayPaymentRequestSessionCreate reference