---
title: shopPayPaymentRequestSessionCreate - Storefront API
description: Create a new Shop Pay payment request session.
api_version: 2024-10
api_name: storefront
type: mutation
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/storefront/2024-10/mutations/shopPayPaymentRequestSessionCreate
  md: >-
    https://shopify.dev/docs/api/storefront/2024-10/mutations/shopPayPaymentRequestSessionCreate.txt
---

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

mutation

Create a new Shop Pay payment request session.

## Arguments

* payment​Request

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

  required

  A payment request object.

* source​Identifier

  [String!](https://shopify.dev/docs/api/storefront/2024-10/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/2024-10/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/2024-10/objects/UserErrorsShopPayPaymentRequestSessionUserErrors)

  non-null

  Error codes for failed Shop Pay payment request session mutations.

***

## Examples

* ### shopPayPaymentRequestSessionCreate reference

## Mutation Reference

```graphql
mutation shopPayPaymentRequestSessionCreate($sourceIdentifier: String!, $paymentRequest: ShopPayPaymentRequestInput!) {
  shopPayPaymentRequestSessionCreate(sourceIdentifier: $sourceIdentifier, paymentRequest: $paymentRequest) {
    shopPayPaymentRequestSession {
      # ShopPayPaymentRequestSession fields
    }
    userErrors {
      field
      message
    }
  }
}
```

## Input

```json
{
  "sourceIdentifier": "<your-sourceIdentifier>",
  "paymentRequest": {
    "discountCodes": [
      "<your-discountCodes>"
    ],
    "lineItems": [
      {
        "label": "<your-label>",
        "quantity": 1,
        "sku": "<your-sku>",
        "requiresShipping": true,
        "image": {},
        "originalLinePrice": {},
        "finalLinePrice": {},
        "lineDiscounts": [
          {}
        ],
        "originalItemPrice": {},
        "finalItemPrice": {},
        "itemDiscounts": [
          {}
        ]
      }
    ],
    "shippingLines": [
      {
        "code": "<your-code>",
        "label": "<your-label>",
        "amount": {}
      }
    ],
    "total": {
      "amount": "29.99",
      "currencyCode": "USD"
    },
    "subtotal": {
      "amount": "29.99",
      "currencyCode": "USD"
    },
    "discounts": [
      {
        "label": "<your-label>",
        "amount": {}
      }
    ],
    "totalShippingPrice": {
      "discounts": [
        {}
      ],
      "originalTotal": {},
      "finalTotal": {}
    },
    "totalTax": {
      "amount": "29.99",
      "currencyCode": "USD"
    },
    "deliveryMethods": [
      {
        "code": "<your-code>",
        "label": "<your-label>",
        "detail": "<your-detail>",
        "amount": {},
        "minDeliveryDate": "",
        "maxDeliveryDate": "",
        "deliveryExpectationLabel": "<your-deliveryExpectationLabel>"
      }
    ],
    "selectedDeliveryMethodType": "SHIPPING",
    "locale": "<your-locale>",
    "presentmentCurrency": "USD",
    "paymentMethod": "<your-paymentMethod>"
  }
}
```