---
title: PaymentSessionStates - Payments Apps API
description: >-
  The possible values that can be used to describe the state of a payment
  transaction.
api_version: 2026-04
api_name: payments-apps
type: union
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/payments-apps/latest/unions/PaymentSessionStates
  md: >-
    https://shopify.dev/docs/api/payments-apps/latest/unions/PaymentSessionStates.md
---

# Payment​Session​States

union

Requires `read_payment_sessions` access scope.

The possible values that can be used to describe the state of a payment transaction.

## Fields with this union

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

  OBJECT

  A unique payment transaction.

***

```graphql
union PaymentSessionStates = PaymentSessionStateBuyerActionRequired | PaymentSessionStateConfirming | PaymentSessionStatePending | PaymentSessionStateRedirecting | PaymentSessionStateRejected | PaymentSessionStateResolved
```