---
title: VerificationSession - Payments Apps API
description: A unique verification transaction.
api_version: 2025-10
api_name: payments-apps
type: object
api_type: graphql
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
---

# 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 URL that Shopify will redirect the buyer to, for 3DS authentication. 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.

  * id

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

    required

    ### Arguments

    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.

  * authentication

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

    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.

  ***

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

  * id

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

    required

    ### Arguments

    The verification session ID.

  * network​Transaction​Id

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

    Deprecated

  * authentication

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

    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.

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