---
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-01
api_name: payments-apps
type: enum
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/payments-apps/2025-01/enums/PaymentSessionStateRejectedReason
  md: https://shopify.dev/docs/api/payments-apps/2025-01/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

  3DS authentication failed. This Reason should be only used when payments processing should not proceed after the 3DS authentication step. In this case, the app must not call the [`paymentSessionConfirm`](https://shopify.dev/docs/api/payments-apps/latest/mutations/paymentSessionConfirm) mutation **Applicable to:** [Credit card extensions](https://shopify.dev/docs/apps/build/payments/credit-card/use-the-cli?framework=remix) only.

* CARD\_​DECLINED

  The credit card 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 credit card has expired.

* INCORRECT\_​ADDRESS

  The provided address is valid but does not match the card's provider record.

* INCORRECT\_​CVC

  The provided CVC is valid but does not match the card's provider record.

* INCORRECT\_​NUMBER

  The provided card number is valid but couldn't be processed.

* INCORRECT\_​PIN

  The provided PIN is valid but does not match the card's provider record.

* INCORRECT\_​ZIP

  The provided ZIP is valid but does not match the card's provider record.

* INVALID\_​CVC

  The provided CVC does not match the expected format.

* INVALID\_​EXPIRY\_​DATE

  The expiry date does not match the date format.

* INVALID\_​NUMBER

  The provided card number does not match the expected format.

* PROCESSING\_​ERROR

  The payment failed to process.

* RISKY

  The payment was rejected by risk control.

***

## Fields

* [Payment​Session​Rejection​Reason​Input.​code](https://shopify.dev/docs/api/payments-apps/2025-01/input-objects/PaymentSessionRejectionReasonInput#field-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/2025-01/objects/PaymentSessionStateRejected#field-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/2025-01/objects/PaymentSessionStateRejected#field-reason)

### Inputs with this enum

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