---
title: PaymentSessionStateRejectedReason - Payments Apps API
description: >-
  The possible values that can be used to describe the reasons why a payment is
  rejected.
api_version: 2025-10
api_name: payments-apps
type: enum
api_type: graphql
source_url:
  html: >-
    https://shopify.dev/docs/api/payments-apps/latest/enums/PaymentSessionStateRejectedReason
  md: >-
    https://shopify.dev/docs/api/payments-apps/latest/enums/PaymentSessionStateRejectedReason.md
---

# Payment​Session​State​Rejected​Reason

enum

The possible values that can be used to describe the reasons why a payment is rejected.

## Valid values

* AUTHENTICATION\_​FAILED

  3D Secure authentication failed. This rejection reason should only be used when a payment has completed the 3DS authentication step but the authentication was unsuccessful or declined. In this case, the app isn't required to call the [`paymentSessionConfirm`](https://shopify.dev/docs/api/payments-apps/latest/mutations/paymentSessionConfirm) mutation to reject the credit card payment. Refer to [Supporting 3-D Secure](https://shopify.dev/docs/apps/build/payments/credit-card/use-the-cli?framework=remix#supporting-3-d-secure) for more information on how to support 3DS.

* CARD\_​DECLINED

  The payment was declined.

* CONFIRMATION\_​REJECTED

  The payments app called the [`paymentSessionConfirm`](https://shopify.dev/docs/api/payments-apps/latest/mutations/paymentSessionConfirm) mutation and Shopify rejected the confirmation.

* EXPIRED\_​CARD

  The card has expired.

* INCORRECT\_​ADDRESS

  The address is incorrect.

* INCORRECT\_​CVC

  The card security code (CVC/CVV) doesn't match the one on file.

* INCORRECT\_​NUMBER

  The card number is incorrect.

* INCORRECT\_​PIN

  The PIN entered doesn't match the one on file.

* INCORRECT\_​ZIP

  The postal code doesn't match the one on file.

* INVALID\_​CVC

  The card security code (CVC/CVV) doesn't match the expected format.

* INVALID\_​EXPIRY\_​DATE

  The card expiration date is invalid or incorrectly formatted.

* INVALID\_​NUMBER

  The card number format is invalid or incomplete.

* PROCESSING\_​ERROR

  An error occurred while processing the payment.

* RISKY

  The payment was rejected by risk control.

***

## Fields

* [Payment​Session​Rejection​Reason​Input.code](https://shopify.dev/docs/api/payments-apps/latest/input-objects/PaymentSessionRejectionReasonInput#fields-code)

  INPUT OBJECT

  The input fields for the reason why the payment was rejected.

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

  OBJECT

  Additional details about a payment's rejected state.

***

## Map

### Fields with this enum

* <-|[Payment​Session​State​Rejected.reason](https://shopify.dev/docs/api/payments-apps/latest/objects/PaymentSessionStateRejected#field-PaymentSessionStateRejected.fields.reason)

### Inputs with this enum

* [Payment​Session​Rejection​Reason​Input.code](https://shopify.dev/docs/api/payments-apps/latest/input-objects/PaymentSessionRejectionReasonInput#fields-code)