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

# Refund​Session​States

union

Requires `read_payment_sessions` access scope.

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

## Possible types

* [Refund​Session​State​Rejected](https://shopify.dev/docs/api/payments-apps/2025-01/objects/RefundSessionStateRejected)

  OBJECT

  Additional details about a refund's rejected state.

  * code

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

    non-null

    The refund state code.

  * merchant​Message

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

    The custom, localized message for the merchant.

  * reason

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

    non-null

    The reason the refund is rejected.

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

  OBJECT

  Additional details about a refund's resolved state.

  * code

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

    non-null

    The refund state code.

***

## Fields with this union

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

  OBJECT

  A unique refund transaction.

***

```graphql
union RefundSessionStates = RefundSessionStateRejected | RefundSessionStateResolved
```