> ## 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.

# Reconciliation

> Reconcile collects against a settlement using balance transactions

Every settlement you receive can be made up of one or more collects. To reconcile a settlement, fetch the collects associated with the settlement ID and verify each transaction against its balance transaction details and reconcile if the total collect sum matches the total settlement amount received.

***

## Reconciling a Settlement

<Steps>
  <Step title="Fetch the collects for the settlement">
    Call the [Fetch Collects API](/api-reference/tazapay-api/fetch-collects) with the settlement ID to get the list of collects included in that settlement.

    ```
    GET /v3/settlement/{id}/transactions/collect
    ```

    Each entry in the response contains the collect `id` and its `balance_transaction_id`. You can get the settlement ID from [settlement webhooks](/api-reference/tazapay-api/settlement-webhooks) or the dashboard.
  </Step>

  <Step title="Get the net amount for each collect">
    From each [collect object](/api-reference/tazapay-api/collects), take the `balance_transaction_id` and call the [Fetch Balance Transaction API](/api-reference/tazapay-api/fetch-balance-transaction) to get the details of the net amount added to your balance and any associated FX.

    ```
    GET /v3/balance_transaction/{id}
    ```

    The balance transaction gives you the full breakdown for that collect:

    | Field                 | What it tells you                                                                                                                 |
    | --------------------- | --------------------------------------------------------------------------------------------------------------------------------- |
    | `amount` / `currency` | The gross amount received, in the incoming currency.                                                                              |
    | `fee_details`         | Fees deducted from the gross amount.                                                                                              |
    | `fx_conversions`      | Any [FX conversion](/collection-accounts/incoming-payments/fx) applied, with the exchange rate and the initial and final amounts. |
    | `net`                 | The net amount credited to your balance after fee deductions and FX conversions.                                                  |
  </Step>

  <Step title="Match the totals">
    Sum the `net` amounts across all balance transactions in the settlement and check that the total matches the settlement amount received in your account.

    If the totals match, the settlement is fully reconciled. If they do not, compare each collect's `net` against your records to isolate the transaction causing the difference.
  </Step>
</Steps>

<Note>
  Amounts are integers with 2 implied decimal places - divide by 100 to get the actual value (100000 is USD 1,000.00). See [Decimal Currencies](/api-reference/appendix/decimal-currencies). Also ensure you compare net amounts in the same currency - collects in a non-holding currency are converted to your primary holding currency before being credited. See [FX](/collection-accounts/incoming-payments/fx).
</Note>

***

## See Also

<CardGroup cols={2}>
  <Card title="Settlements" icon="money-bill" href="/api-reference/tazapay-api/settlements-1">
    The settlement object and how settlements work.
  </Card>

  <Card title="Balance Transactions" icon="clock-rotate-left" href="/getting-started/core-concepts/fx-transaction/overview">
    Tracking credits and debits across your balances.
  </Card>

  <Card title="FX" icon="money-bill-transfer" href="/collection-accounts/incoming-payments/fx">
    When currency conversion happens on incoming collects.
  </Card>

  <Card title="Collect Object" icon="file-lines" href="/api-reference/tazapay-api/collects">
    Field-level reference for the collect object.
  </Card>
</CardGroup>