---
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-01
api_name: payments-apps
type: union
api_type: graphql
source_url:
  html: https://shopify.dev/docs/api/payments-apps/2025-01/unions/VoidSessionStates
  md: https://shopify.dev/docs/api/payments-apps/2025-01/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/2025-01/objects/VoidSessionStateRejected)

  OBJECT

  Additional details about a void's rejected state.

  * code

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

    non-null

    The void state code.

  * merchant​Message

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

    The custom, localized message for the merchant.

  * reason

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

    non-null

    The reason the void is rejected.

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

  OBJECT

  Additional details about a void's resolved state.

  * code

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

    non-null

    The void state code.

***

## Fields with this union

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

  OBJECT

  A unique void transaction.

***

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