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

# Capture​Session​States

union

Requires `read_payment_sessions` access scope.

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

## Possible types

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

  OBJECT

  Additional details about a capture's rejected state.

  * code

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

    non-null

    The capture state code.

  * merchant​Message

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

    The custom, localized message for the merchant.

  * reason

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

    non-null

    The reason the capture is rejected.

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

  OBJECT

  Additional details about a capture's resolved state.

  * code

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

    non-null

    The capture state code.

***

## Fields with this union

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

  OBJECT

  Represents a unique capture transaction.

***

```graphql
union CaptureSessionStates = CaptureSessionStateRejected | CaptureSessionStateResolved
```