---
title: shopPayPaymentRequestSessionCreate - Storefront API
description: Create a new Shop Pay payment request session.
api_version: 2025-10
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

Create a new Shop Pay payment request session.

## 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

## 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>"
  }
}
```

##### Variables

```
{
  "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>"
  }
}
```

##### Schema

```
input ShopPayPaymentRequestInput {
  discountCodes: [String!]
  lineItems: [ShopPayPaymentRequestLineItemInput!]
  shippingLines: [ShopPayPaymentRequestShippingLineInput!]
  total: MoneyInput!
  subtotal: MoneyInput!
  discounts: [ShopPayPaymentRequestDiscountInput!]
  totalShippingPrice: ShopPayPaymentRequestTotalShippingPriceInput
  totalTax: MoneyInput
  deliveryMethods: [ShopPayPaymentRequestDeliveryMethodInput!]
  selectedDeliveryMethodType: ShopPayPaymentRequestDeliveryMethodType
  locale: String!
  presentmentCurrency: CurrencyCode!
  paymentMethod: String
}

input ShopPayPaymentRequestLineItemInput {
  label: String
  quantity: Int!
  sku: String
  requiresShipping: Boolean
  image: ShopPayPaymentRequestImageInput
  originalLinePrice: MoneyInput
  finalLinePrice: MoneyInput
  lineDiscounts: [ShopPayPaymentRequestDiscountInput!]
  originalItemPrice: MoneyInput
  finalItemPrice: MoneyInput
  itemDiscounts: [ShopPayPaymentRequestDiscountInput!]
}

input ShopPayPaymentRequestShippingLineInput {
  code: String
  label: String
  amount: MoneyInput
}

input MoneyInput {
  amount: Decimal!
  currencyCode: CurrencyCode!
}

input ShopPayPaymentRequestDiscountInput {
  label: String
  amount: MoneyInput
}

input ShopPayPaymentRequestTotalShippingPriceInput {
  discounts: [ShopPayPaymentRequestDiscountInput!]
  originalTotal: MoneyInput
  finalTotal: MoneyInput
}

input ShopPayPaymentRequestDeliveryMethodInput {
  code: String
  label: String
  detail: String
  amount: MoneyInput
  minDeliveryDate: ISO8601DateTime
  maxDeliveryDate: ISO8601DateTime
  deliveryExpectationLabel: String
}
```