Reconciliation

Each reversed payout is represented by two explicitly linked balance transactions:

1. Payout debit

   Created when the payout was processed

   Type: payout

   Operation Type: debit

2. Payout reversal credit

   Created when the payout is reversed

   Type: payout_reversal

   Operation Type: credit

These two transactions together represent the full financial lifecycle of the payout.

How to identify the correct transactions

To reconcile a reversed payout:

1. Fetch the payout using the Payout API
2. Note the payout ID (for example: pot_xxxxx)
3. Fetch balance transactions where:
   • type = payout and source = <payout_id>
   • type = payout_reversal and description references the same payout

How to compute the net financial impact

Reconciliation should be based on the net balance impact, calculated as:

Net impact= payout_reversal.net.amount − payout.net.amount

Important points to note:

• The reversal credit amount may not exactly match the original payout debit
• Differences can occur due to:
  • Third-party bank or network-level return fees
  • FX rate differences between payout time and reversal time
  • Intermediary charges applied by downstream institutions
• All such differences are transparently itemized in the reversal balance transaction

Third-party fees and FX rate visibility

TazaPay provides full visibility into fees and exchange rates applied during a payout reversal.

For each payout_reversal balance transaction, merchants can view:

• Third-party fees

  Returned under fee_details, representing bank, PSP, or network fees incurred during the payout or reversal process.

  These fees may be reported in currencies different from the payout currency and are transparently itemized.

• Applied FX rates

  Returned under fx_conversions, showing:

  • The exchange rates applied at the time of reversal
  • Converted amounts across currencies
  • Any third-party or holding-currency FX movements

Using the balance transaction object for reconciliation

The balance transaction object provides all required reconciliation inputs:

• amount and currency: Gross credited or debited amount
• operation_type: debit or credit
• fee_details: Any applied fixed or variable fees
• fx_conversions: FX rates used and converted amounts
• net: Final net balance impact
• created_at: Timestamp for ledger ordering
• type: payout or payout_reversal

For reconciliation systems, TazaPay recommends using the net.amount field as the authoritative value for ledger posting.