---
title: VerificationSession - Payments Apps API
description: A unique verification transaction.
api_version: 2026-10
source_url:
  html: >-
    https://shopify.dev/docs/api/payments-apps/latest/objects/VerificationSession
  md: >-
    https://shopify.dev/docs/api/payments-apps/latest/objects/VerificationSession.md
api_name: payments-apps
api_type: graphql
type: object
---

# Verification​Session

object

Requires `read_payment_sessions` access scope.

A unique verification transaction.

## Fields

* id

  [ID!](https://shopify.dev/docs/api/payments-apps/latest/scalars/ID)

  non-null

  A globally-unique ID.

* next​Action

  [Verification​Session​Next​Action](https://shopify.dev/docs/api/payments-apps/latest/objects/VerificationSessionNextAction)

  The next action expected of the partner.

* state

  [Verification​Session​States!](https://shopify.dev/docs/api/payments-apps/latest/unions/VerificationSessionStates)

  non-null

  Details about the verification state.

***

## Map

No referencing types

***

## Mutations

* [verification​Session​Redirect](https://shopify.dev/docs/api/payments-apps/latest/mutations/verificationSessionRedirect)

  mutation

  Redirects the buyer to the given URL for the verification session. Shopify will redirect the buyer to the URL where the 3DS authentication will take place when verifying the buyer's credit\_card.

  * id

    [ID!](https://shopify.dev/docs/api/payments-apps/latest/scalars/ID)

    required

    ### Arguments

    The verification session ID.

  * redirect​Url

    [URL!](https://shopify.dev/docs/api/payments-apps/latest/scalars/URL)

    required

    The absolute HTTPS URL, including a host, that Shopify will redirect the buyer to for 3DS authentication. The URL must not contain ASCII control characters, spaces in the scheme or authority, or user information before the hostname, such as a username or password. Spaces in the path, query string, or fragment are allowed. Applicable to verifications with the credit card payment method only.

  ***

* [verification​Session​Reject](https://shopify.dev/docs/api/payments-apps/latest/mutations/verificationSessionReject)

  mutation

  Rejects an open verification session. After the `verificationSessionReject` mutation completes on a given verification session, any `verificationSessionResolve` mutation attempts will fail. Subsequent `verificationSessionReject` mutation attempts will succeed, but the `RejectionReasonInput` argument will be ignored.

  * authentication

    [Verification​Session​Three​DSecure​Authentication](https://shopify.dev/docs/api/payments-apps/latest/input-objects/VerificationSessionThreeDSecureAuthentication)

    ### Arguments

    The 3D Secure authentication data from the partner. Must be present if and only if the Redirect mutation has been called and the payment method is credit card.

  * id

    [ID!](https://shopify.dev/docs/api/payments-apps/latest/scalars/ID)

    required

    The verification session ID.

  * reason

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

    required

    The rejection reason.

  ***

* [verification​Session​Resolve](https://shopify.dev/docs/api/payments-apps/latest/mutations/verificationSessionResolve)

  mutation

  Resolves an open verification session. After the `verificationSessionResolve` mutation completes on a given verification session, any `verificationSessionReject` mutation attempts will fail. Subsequent `verificationSessionResolve` mutation attempts will succeed, but the `Details` argument will be ignored.

  * authentication

    [Verification​Session​Three​DSecure​Authentication](https://shopify.dev/docs/api/payments-apps/latest/input-objects/VerificationSessionThreeDSecureAuthentication)

    ### Arguments

    The 3D Secure authentication data from the partner. Must be present if and only if the Redirect mutation has been called and the payment method is credit card.

  * id

    [ID!](https://shopify.dev/docs/api/payments-apps/latest/scalars/ID)

    required

    The verification session ID.

  * network​Transaction​Id

    [String](https://shopify.dev/docs/api/payments-apps/latest/scalars/String)

    Deprecated

  * payment​Details

    [Verification​Session​Payment​Details​Input](https://shopify.dev/docs/api/payments-apps/latest/input-objects/VerificationSessionPaymentDetailsInput)

    The payment details used to process the verification.

  ***

***

## VerificationSession Mutations

### Mutated by

* [verification​Session​Redirect](https://shopify.dev/docs/api/payments-apps/latest/mutations/verificationSessionRedirect)
* [verification​Session​Reject](https://shopify.dev/docs/api/payments-apps/latest/mutations/verificationSessionReject)
* [verification​Session​Resolve](https://shopify.dev/docs/api/payments-apps/latest/mutations/verificationSessionResolve)