Reconciliation
Verify Fynex settlement records against your own books using the Fynex dashboard and the wallet transactions API.
Reconciliation compares what Fynex has recorded as settled funds against what actually arrived in your bank account. Each reconciliation record represents a settlement deposit event with three amounts: reported (what the processor claimed), expected (what Fynex calculated), and actual (what was received).
Note
Reconciliation records are available in the Fynex dashboard, for users with the reconciliations read permission. There is no public API for them. To match settlements programmatically, use the wallet transactions endpoint described below.
Use cases
- Daily settlement matching — review the previous day's reconciliation records in the dashboard and compare reported vs actual amounts to detect shortfalls.
- Dispute investigation — open a single record to see where fees differ between reported and expected for a specific deposit event.
- Ledger matching in your own systems — page through wallet transactions over the API and compare them with your books.
Reconciliation workflow
Check the overview in the dashboard. Look at the counts of successful, pending and discrepancy records for your date range.
Focus on pending and discrepancy records. Filter the list by status.
Open a specific record to see the facts that show where fees diverge between reported, expected, and actual amounts.
Cross-reference with wallet transactions. Each settled payment that contributed to a deposit has a credit entry on your wallet. Fetch them with
GET /payments-api/v1/wallets/{wallet_id}/transactions?limit=100&offset=0and compare the credited amounts (kind: incoming_payment_processed) for the period with the actual deposit amount. Each entry carriesbalanceAfterMinorso you can check your own running balance. See Wallets.
curl -s "https://api.fynex.ai/payments-api/v1/wallets/15/transactions?limit=100&offset=0" \
-H "Authorization: Bearer $FYNEX_TOKEN"
- Escalate discrepancies to your Fynex account manager if the actual deposit differs from the expected amount and the facts do not explain the gap.
Note
Raw processor-side settlement records (the underlying settlement file contents) are not part of the seller-facing product. Their shape follows whichever processor is configured for the seller, so the field names are not a stable public contract.
See also
- Wallets — Inspect wallet ledger transactions that correspond to reconciled settlements.
- Payment Lifecycle — Understand the status transitions a payment goes through before it settles.