> ## Documentation Index
> Fetch the complete documentation index at: https://developer.tazapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Introduction of Payout Reversal

# Get Payout API Changes

The **Get Payout API** has been enhanced to provide additional details for payout reversal scenarios. A new payout state, **`reversed`**, has been introduced along with additional fields to improve traceability and visibility into reversal-related transactions and FX movements.

## New State Introduced

* **`reversed`**
  Indicates that a previously succeeded payout has been successfully reversed.

## New Fields Added

* **`reversal_balance_transaction`**\
  References the balance transaction created as part of the payout reversal.

* **`reversal_payout_fx_transaction`**\
  Represents the FX transaction applied during the payout-side reversal process.

# Fetch Balance Transaction API

Updates have been made to the fee representation for reversal transactions in the **Balance Transaction** object.

## Fee Structure Update

For reversal transactions, the API now returns **`third_party_fee`** instead of **`payout_fee`** in the **Fee** object.

| Field        | Behaviour         | Purpose                                                           |
| ------------ | ----------------- | ----------------------------------------------------------------- |
| fee\_details | third\_party\_fee | Distinguishes third-party charges applied during payout reversals |

## FX Structure Update

For reversal transactions, the API now returns **`third_party_fx`** along with holding FX transactions in the **FX** object.

| Field           | Behaviour             | Purpose                                                                 |
| --------------- | --------------------- | ----------------------------------------------------------------------- |
| fx\_conversions | third\_party\_fx      | Represents FX charges applied by third-party providers during reversals |
| fx\_conversions | reversal\_holding\_fx | Represents the FX movement on the holding-currency side of a reversal   |

These updates provide clearer visibility into the fee components associated with reversed payouts.

# New Reversal Reason Codes

Comprehensive [reason codes](/api-reference/appendix/payout-reversal-reasons) have been introduced for payout reversals to help identify the exact cause of a reversal.

## Relevant Links

* [**GET Payout**](/api-reference/tazapay-api/fetch-payout)
* [**Payout Webhooks**](/api-reference/tazapay-api/payout-webhooks)
* [**GET Balance Transaction**](/api-reference/tazapay-api/fetch-balance-transaction)