---
title: paymentSessionPending - Payments Apps API
description: >-
  Change a payment session status to pending.


  Upon receiving the response from the `PaymentSessionPending` mutation,

  you must redirect the customer back to Shopify, using `redirectUrl` in
  `nextAction`.


  Upon completion, pending payments must be finalized into either a successful
  or failed state using

  the `paymentSessionResolve` or `paymentSessionReject` mutations.

  Both `sale` and `authorization` payments can be marked as pending.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/payments-apps/latest/mutations/paymentSessionPending
  md: >-
    https://shopify.dev/docs/api/payments-apps/latest/mutations/paymentSessionPending.md
api_name: payments-apps
api_type: graphql
type: mutation
---

# payment​Session​Pending

mutation

Requires `write_payment_sessions` access scope.

Change a payment session status to pending.

Upon receiving the response from the `PaymentSessionPending` mutation, you must redirect the customer back to Shopify, using `redirectUrl` in `nextAction`.

Upon completion, pending payments must be finalized into either a successful or failed state using the `paymentSessionResolve` or `paymentSessionReject` mutations. Both `sale` and `authorization` payments can be marked as pending.

## Arguments

* id

  [ID!](https://shopify.dev/docs/api/payments-apps/latest/scalars/ID)

  required

  The payment session ID.

* pending​Expires​At

  [Date​Time!](https://shopify.dev/docs/api/payments-apps/latest/scalars/DateTime)

  required

  The date and time when the pending payment expires, recommended to be within 3 days.

* reason

  [Payment​Session​State​Pending​Reason!](https://shopify.dev/docs/api/payments-apps/latest/enums/PaymentSessionStatePendingReason)

  required

  The reason the payment is pending.

***

## Payment​Session​Pending​Payload returns

* payment​Session

  [Payment​Session](https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSession)

  The updated payment session.

* user​Errors

  [\[Payment​Session​Pending​User​Error!\]!](https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSessionPendingUserError)

  non-null

  The list of errors that occurred from executing the mutation.

***

## Examples

* ### paymentSessionPending reference