---
title: PaymentSessionState - Payments Apps API
description: The state of a payment transaction.
api_version: 2025-01
api_name: payments-apps
type: interface
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/payments-apps/2025-01/interfaces/PaymentSessionState
  md: https://shopify.dev/docs/api/payments-apps/2025-01/interfaces/PaymentSessionState.md
---

# Payment​Session​State

interface

The state of a payment transaction.

## Fields

* code

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

  non-null

  The payment state code.

***

## Types implemented in

* [Payment​Session​State​Confirming](https://shopify.dev/docs/api/payments-apps/2025-01/objects/PaymentSessionStateConfirming)

  OBJECT

  Additional details about a payment's confirming state.

  * code

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

    non-null

    The payment state code.

* [Payment​Session​State​Pending](https://shopify.dev/docs/api/payments-apps/2025-01/objects/PaymentSessionStatePending)

  OBJECT

  Additional details about a payment's pending state.

  * code

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

    non-null

    The payment state code.

  * reason

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

    The reason the payment is pending.

* [Payment​Session​State​Redirecting](https://shopify.dev/docs/api/payments-apps/2025-01/objects/PaymentSessionStateRedirecting)

  OBJECT

  Additional details about a payment's redirecting state.

  * code

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

    non-null

    The payment state code.

* [Payment​Session​State​Rejected](https://shopify.dev/docs/api/payments-apps/2025-01/objects/PaymentSessionStateRejected)

  OBJECT

  Additional details about a payment's rejected state.

  * code

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

    non-null

    The payment state code.

  * merchant​Message

    [String](https://shopify.dev/docs/api/payments-apps/2025-01/scalars/String)

    The custom, localized message for the merchant.

  * reason

    [Payment​Session​State​Rejected​Reason!](https://shopify.dev/docs/api/payments-apps/2025-01/enums/PaymentSessionStateRejectedReason)

    non-null

    The reason the payment is rejected.

* [Payment​Session​State​Resolved](https://shopify.dev/docs/api/payments-apps/2025-01/objects/PaymentSessionStateResolved)

  OBJECT

  Additional details about a payment's resolved state.

  * code

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

    non-null

    The payment state code.

***

```json
{
	"code": ""
}
```