---
name: reconcile-invoices-to-payouts
description: Reconcile Fynex invoices, payments, wallet ledger entries and payouts against each other and against a bank statement. Use when the user needs to reconcile, close the books, match an invoice to the payment that settled it or the payout that carried it, export invoices for accounting, explain a balance that does not add up, or trace where a specific amount went. Covers the settlement trail, the wallet ledger, bulk export and the joins that actually hold.
---

# Reconcile on Fynex

Two APIs, one host, one key. Invoices say how much; payments and payouts say what moved.

## The joins

- `GET /billing-api/v1/invoices/{invoiceId}/settlement` — the trail from an invoice to the
  payment and payout behind it. This is the join; do not rebuild it from timestamps.
- `GET /billing-api/v1/invoices/export` — a period in bulk, for a spreadsheet or a warehouse.
- `GET /payments-api/v1/wallets/{wallet_id}/transactions` — the ledger. Delta-based: each
  row carries the signed change it made and the balance after it, so reconcile against
  `balanceAfterMinor` rather than re-summing deltas.
- `GET /payments-api/v1/payouts/{id}` — `providerReference` is the upstream reference to
  match a bank statement line against. Opaque: match on it, do not parse it.

## Rules that bite

- **`amountMinor` on a ledger row is unsigned.** Direction is in `direction` and in the
  signed deltas, not in the sign of the amount.
- **A wallet's `totalBalanceMinor` is not spendable.** It sums available + held + pending,
  and held is committed to an in-flight payout.
- **`isLiability` separates credit the customer paid for from credit you granted.** They
  are not interchangeable on a balance sheet, so do not sum across it.
- **Issued invoices are append-only.** A correction is a credit note, never an edit — if
  you are looking for a changed invoice, look for the note that corrects it.
- **Open-period usage is not the invoice figure.** Reconcile to invoices, not to the meter.

## Read next

- [Reconciliation guide](/payments-api/v2/docs/reconciliation.md) · [Wallets](/payments-api/v2/docs/wallets.md)
- [Invoices](/billing-api/v1/docs/invoices.md) · [Credits](/billing-api/v1/docs/credits.md)
- [Both APIs](/api-reference) · [Everything inlined](/llms-full.txt)