---
title: PaymentSessionPendingPayload - Payments Apps API
description: Return type for `paymentSessionPending` mutation.
api_version: 2026-04
source_url:
  html: >-
    https://shopify.dev/docs/api/payments-apps/latest/payloads/PaymentSessionPendingPayload
  md: >-
    https://shopify.dev/docs/api/payments-apps/latest/payloads/PaymentSessionPendingPayload.md
api_name: payments-apps
api_type: graphql
type: payload
---

# Payment​Session​Pending​Payload

payload

Return type for `paymentSessionPending` mutation.

## Fields

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

***

## Mutations with this payload

* [payment​Session​Pending](https://shopify.dev/docs/api/payments-apps/latest/mutations/paymentSessionPending)

  mutation

  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.

  * id

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

    required

    ### Arguments

    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.

  ***

***

## Map

### Mutations with this payload

* [payment​Session​Pending](https://shopify.dev/docs/api/payments-apps/latest/mutations/paymentSessionPending)