---
title: VoidSessionStates - Payments Apps API
description: >-
  The possible values that can be used to describe the state of a finalized void
  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/VoidSessionStates'
  md: >-
    https://shopify.dev/docs/api/payments-apps/latest/unions/VoidSessionStates.md
---

# Void​Session​States

union

Requires `read_payment_sessions` access scope.

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

## Possible types

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

  OBJECT

  Additional details about a void's rejected state.

  * code

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

    non-null

    The void state code.

  * merchant​Message

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

    The custom, localized message for the merchant.

  * reason

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

    non-null

    The reason the void is rejected.

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

  OBJECT

  Additional details about a void's resolved state.

  * code

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

    non-null

    The void state code.

***

## Fields with this union

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

  OBJECT

  A unique void transaction.

***

```graphql
union VoidSessionStates = VoidSessionStateRejected | VoidSessionStateResolved
```