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

# Payment​Session​State​Rejected

object

Requires `read_payment_sessions` access scope.

Additional details about a payment's rejected state.

## Fields

* code

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

  non-null

  The payment state code.

* merchant​Message

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

  The custom, localized message for the merchant.

* reason

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

  non-null

  The reason the payment is rejected.

***

## 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

***

## ||-PaymentSessionStateRejected Implements

### Implements

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