---
title: ShopPayPaymentRequestSessionCreatePayload - Storefront API
description: Return type for `shopPayPaymentRequestSessionCreate` mutation.
api_version: 2026-04
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/latest/payloads/ShopPayPaymentRequestSessionCreatePayload
  md: >-
    https://shopify.dev/docs/api/storefront/latest/payloads/ShopPayPaymentRequestSessionCreatePayload.md
api_name: storefront
api_type: graphql
type: payload
---

# Shop​Pay​Payment​Request​Session​Create​Payload

payload

Return type for `shopPayPaymentRequestSessionCreate` mutation.

## Fields

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

***

## Mutations with this payload

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

  * source​Identifier

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

    required

    ### Arguments

    A unique identifier for the payment request session.

  * payment​Request

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

    required

    A payment request object.

  ***

***

## Map

### Mutations with this payload

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