---
title: VerificationSessionStates - Payments Apps API
description: The possible values that can be used to describe the state of a verification transaction.
api_version: 2025-10
api_name: payments-apps
type: union
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/payments-apps/latest/unions/VerificationSessionStates
  md: https://shopify.dev/docs/api/payments-apps/latest/unions/VerificationSessionStates.md
---

# Verification​Session​States

union

Requires `read_payment_sessions` access scope.

The possible values that can be used to describe the state of a verification transaction.

## Possible types

* [Verification​Session​State​Redirecting](https://shopify.dev/docs/api/payments-apps/latest/objects/VerificationSessionStateRedirecting)

  OBJECT

  Additional details about a verification's redirecting state.

  * code

    [Verification​Session​State​Code!](https://shopify.dev/docs/api/payments-apps/latest/enums/VerificationSessionStateCode)

    non-null

    The verification state code.

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

  OBJECT

  Additional details about a verification's rejected state.

  * code

    [Verification​Session​State​Code!](https://shopify.dev/docs/api/payments-apps/latest/enums/VerificationSessionStateCode)

    non-null

    The verification state code.

  * reason

    [Verification​Session​State​Reason!](https://shopify.dev/docs/api/payments-apps/latest/enums/VerificationSessionStateReason)

    non-null

    The reason the verification is rejected.

* [Verification​Session​State​Resolved](https://shopify.dev/docs/api/payments-apps/latest/objects/VerificationSessionStateResolved)

  OBJECT

  Additional details about a verification's resolved state.

  * code

    [Verification​Session​State​Code!](https://shopify.dev/docs/api/payments-apps/latest/enums/VerificationSessionStateCode)

    non-null

    The verification state code.

***

## Fields with this union

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

  OBJECT

  A unique verification transaction.

***

```graphql
union VerificationSessionStates = VerificationSessionStateRedirecting | VerificationSessionStateRejected | VerificationSessionStateResolved
```