---
title: PaymentSessionStateRejectedReason - Payments Apps API
description: >-
  The possible values that can be used to describe the reasons why a payment is
  rejected.
api_version: 2026-04
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

* AMOUNT\_​TOO\_​LARGE

  The amount exceeds the maximum amount allowed.

* AMOUNT\_​TOO\_​SMALL

  The amount is below the minimum amount allowed.

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

* AUTHENTICATION\_​REQUIRED

  The payment required 3D Secure authentication but was attempted without authentication.

* CALL\_​ISSUER

  The issuer declined the payment. The buyer should contact their issuer for more details.

* CANCELLED\_​PAYMENT

  The payment was cancelled.

* CARD\_​DECLINED

  The card was declined.

* CARD\_​TESTING

  The payment was blocked due to suspected card testing behaviour.

* CONFIRMATION\_​REJECTED

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

* DO\_​NOT\_​HONOR

  The issuer declined the payment without providing a specific reason.

* EXPIRED\_​CARD

  The card has expired.

* FRAUD\_​SUSPECTED

  The payment was declined due to suspected fraudulent activity.

* HIGH\_​RISK\_​FRAUD\_​SUSPECTED

  The payment was declined due to high fraud risk indicators. The payment instrument may have been reported as lost or stolen.

* INCORRECT\_​ADDRESS

  The address is incorrect.

* INCORRECT\_​CVC

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

* INCORRECT\_​NUMBER

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

* INSTRUMENT\_​DECLINED

  The payment instrument was declined.

* INSUFFICIENT\_​FUNDS

  The payment method has insufficient funds to complete the payment.

* INVALID\_​AMOUNT

  The payment amount is invalid or incorrectly calculated.

* INVALID\_​CURRENCY

  The currency isn't supported.

* 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 number has an invalid or incomplete format.

* INVALID\_​PAYMENT\_​METHOD

  The payment method or its associated account is invalid or not found.

* INVALID\_​PURCHASE\_​TYPE

  This payment method doesn't support the requested payment type.

* INVALID\_​REQUEST

  The payment request is missing required parameters or contains invalid values.

* MERCHANT\_​ACCOUNT\_​ERROR

  The payment couldn't be processed due to an issue with the merchant account.

* MERCHANT\_​RULE

  The payment was blocked due to merchant's custom payment risk rule.

* PAYMENT\_​METHOD\_​UNSUPPORTED

  The payment method isn't supported.

* PICK\_​UP\_​CARD

  The card can't be used for this payment. The cardholder may have reported it as lost or stolen.

* PROCESSING\_​ERROR

  An error occurred while processing the payment.

* RETRY\_​DECLINED

  The payment retry attempt was declined.

* TRANSACTION\_​LIMIT\_​EXCEEDED

  The payment instrument has exceeded the processing frequency limit.

* RISKY

  Deprecated

***

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