---
title: PaymentSessionStatePending - Payments Apps API
description: Additional details about a payment's pending state.
api_version: 2026-04
source_url:
  html: >-
    https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSessionStatePending
  md: >-
    https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSessionStatePending.md
api_name: payments-apps
api_type: graphql
type: object
---

# Payment​Session​State​Pending

object

Requires `read_payment_sessions` access scope.

Additional details about a payment's pending state.

## Fields

* code

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

  non-null

  The payment state code.

* reason

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

  The reason the payment is pending.

***

## Map

### Possible type in

* [Payment​Session​States](https://shopify.dev/docs/api/payments-apps/latest/unions/PaymentSessionStates)

***

## Interfaces

* [Payment​Session​State](https://shopify.dev/docs/api/payments-apps/latest/interfaces/PaymentSessionState)

  interface

***

## PaymentSessionStatePending Implements

### Implements

* [Payment​Session​State](https://shopify.dev/docs/api/payments-apps/latest/interfaces/PaymentSessionState)
