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

# Verification​Session​State​Reason

enum

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

## Valid values

* AUTHENTICATION\_​FAILED

  Credit card only. 3DS authentication failed. This Reason should be only used when the payments app does not want to proceed and confirm the payment after the 3DS authentication step.

* CARD\_​DECLINED

  Credit card only. Credit card declined.

* EXPIRED\_​CARD

  Credit card only. Credit card expired.

* GENERIC\_​ERROR

  Verification processing failure.

* INCORRECT\_​ADDRESS

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

* INCORRECT\_​CVC

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

* INCORRECT\_​ZIP

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

* INVALID\_​CVC

  Credit card only. The provided CVC does not match the expected format.

* INVALID\_​EXPIRY\_​DATE

  Credit card only. The expiry date does not match the date format.

* INVALID\_​NUMBER

  Credit card only. The provided card number does not match the expected format.

* RESOURCE\_​INVALID

  The payment token is not valid for this use case (e.g., customer/payment method mismatch).

* RESOURCE\_​NOT\_​FOUND

  The payment method could not be found in the payment provider's system.

***

## Fields

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

  INPUT OBJECT

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

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

  OBJECT

  Additional details about a verification's rejected state.

***

## Map

### Fields with this enum

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

### Inputs with this enum

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