---
title: PaymentSessionStateRejected - Payments Apps API
description: Additional details about a payment's rejected state.
api_version: 2026-10
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
api_name: payments-apps
api_type: graphql
type: object
---

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

* source

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

  The entity that rejected the payment.

***

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