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

# 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/2025-04/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/2025-04/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/2025-04/mutations/shopPayPaymentRequestSessionCreate)

  mutation

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