---
title: verificationSessionReject - Payments Apps API
description: |-
  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.
api_version: 2025-10
api_name: payments-apps
type: mutation
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/payments-apps/latest/mutations/verificationSessionReject
  md: https://shopify.dev/docs/api/payments-apps/latest/mutations/verificationSessionReject.md
---

# verification​Session​Reject

mutation

Requires `write_payment_sessions` access scope.

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.

## Arguments

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

* 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​Reject​Payload returns

* user​Errors

  [\[Verification​Session​User​Error!\]!](https://shopify.dev/docs/api/payments-apps/latest/objects/VerificationSessionUserError)

  non-null

  The list of errors that occurred from executing the mutation.

* verification​Session

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

  The updated verification session.

***

## Examples

* ### verificationSessionReject reference

## Mutation Reference

```graphql
mutation verificationSessionReject($id: ID!, $reason: VerificationSessionRejectionReasonInput!, $authentication: VerificationSessionThreeDSecureAuthentication) {
  verificationSessionReject(id: $id, reason: $reason, authentication: $authentication) {
    userErrors {
      field
      message
    }
    verificationSession {
      # VerificationSession fields
    }
  }
}
```

## Input

```json
{
  "id": "gid://shopify/<objectName>/10079785100",
  "reason": {
    "code": "GENERIC_ERROR"
  },
  "authentication": {
    "authenticationData": {
      "transStatus": "Y",
      "transStatusReason": "<your-transStatusReason>",
      "authenticationFlow": "FRICTIONLESS",
      "version": "V2_3",
      "chargebackLiability": "MERCHANT"
    },
    "partnerError": "PROCESSING_ERROR"
  }
}
```

##### Variables

```
{
  "id": "gid://shopify/<objectName>/10079785100",
  "reason": {
    "code": "GENERIC_ERROR"
  },
  "authentication": {
    "authenticationData": {
      "transStatus": "Y",
      "transStatusReason": "<your-transStatusReason>",
      "authenticationFlow": "FRICTIONLESS",
      "version": "V2_3",
      "chargebackLiability": "MERCHANT"
    },
    "partnerError": "PROCESSING_ERROR"
  }
}
```

##### Schema

```
input VerificationSessionRejectionReasonInput {
  code: VerificationSessionStateReason!
}

input VerificationSessionThreeDSecureAuthentication {
  authenticationData: VerificationSessionThreeDSecureAuthenticationData
  partnerError: VerificationSessionThreeDSecurePartnerError
}

input VerificationSessionThreeDSecureAuthenticationData {
  transStatus: VerificationSessionThreeDSecureTransStatus!
  transStatusReason: String
  authenticationFlow: VerificationSessionThreeDSecureAuthenticationFlow!
  version: VerificationSessionThreeDSecureVersion!
  chargebackLiability: VerificationSessionThreeDSecureChargebackLiability!
}
```