Overview
Reconciliation and reporting should be centralized across Ramps, QR Payments, CaaS, Bill Payments, Virtual Accounts and Broker.
Use this section as the single source of truth for:
- operation tracking,
- balance-level reporting,
- accounting controls.
1. Track operation outcomes
Use operation entities for end-to-end status tracking:
| Flow | Recommended queries |
|---|---|
| Ramps (automatic/manual) | GET /v2/synthetics, GET /v2/deposits, GET /v2/withdraws |
| QR Payments | GET /v2/synthetics |
| Bill Payments | GET /v2/synthetics |
| Virtual Accounts | GET /wallet/v1/transfers — filter by type=DEPOSIT (collections) or type=WITHDRAW (payouts) |
| Broker | GET /broker/v1/api/order, GET /broker/v1/api/synthetic, GET /broker/v1/api/banking/deposit, GET /broker/v1/api/banking/withdraw, GET /broker/v1/api/holdingIncome |
If you receive webhooks, treat webhooks as real-time signals and these queries as your source for recovery/replay.
2. Reconcile balances
Use balance and activity endpoints to validate deltas and period snapshots:
| Purpose | Endpoint | API Reference |
|---|---|---|
| Current balances | GET /v2/user-balances, GET /v2/user-balances/USERANYID | Get User Balance |
| Balance movements | GET /v2/balance-activities | Get Activities |
| End-of-period snapshots | GET /v2/balance-activities/snapshots | Get Users Balance Snapshots |
| Broker user balances | GET /broker/v1/api/balance/USERANYID | Get user balance |
Balance activities fields
GET /v2/stats/balance-activities returns one record per balance movement. Key fields:
| Field | Description |
|---|---|
externalReferenceId | Your external identifier for the originating operation |
internalReferenceId | Manteca's internal reference |
amount | Total transaction value |
balanceAmount | Portion debited or credited from available balance |
overdraftAmount | Portion handled as operational overdraft |
remainingBalance | Balance after this movement |
description | Origin of the movement (see values below) |
description values
description values| Value | Meaning |
|---|---|
PAYMENT_CREATION | Debit for a QR payment |
PAYMENT_CANCELLATION | Credit on QR payment cancellation or refund |
PAYMENT_PARTIAL_REFUND | Credit on QR payment partial refund |
BILL_PAYMENT | Debit for a bill payment |
BILL_PAYMENT_REFUND | Credit on bill payment refund |
WITHDRAW_CREATION | Debit for an outbound withdrawal |
WITHDRAW_CANCELLATION | Credit on withdrawal cancellation |
WITHDRAW_COST_DEBT | Debit for withdrawal network fee |
WITHDRAW_COST_DEBT_REFUND | Credit on withdrawal fee refund |
DEPOSIT_CREATION | Credit for an inbound deposit |
ORDER_CREATION | Debit or credit from a trade order |
ORDER_REVERSAL | Debit or credit from a trade order reversal |
INTERNAL_MOVEMENT | Internal balance movement between accounts |
LOCK_FUNDS | Debit when funds are locked |
UNLOCK_FUNDS | Credit when locked funds are released |
Balance snapshots
Snapshots are generated daily at midnight GMT-3. They represent a point-in-time balance view.
Snapshots are fuzzy by design: transactions processing at snapshot time may appear in the next day's snapshot rather than the current one. Do not use snapshots as the sole source of truth for intraday reconciliation — use balance-activities for movement-level accuracy.
3. Company accounting
Accounting endpoints show your company-level position across products, including Broker — Broker debt, credit and settlements consolidate into the same accounting surface:
| Purpose | Endpoint | API Reference |
|---|---|---|
| Portfolio summary | GET /v2/accounting/summary | Get Accounting Summary |
| Net position | GET /v2/accounting/net-balance | Get Accounting Net Balance |
| Debt ledger | GET /v2/accounting/debt | Get Accounting Debt |
| Credit ledger | GET /v2/accounting/credit | Get Accounting Credit |
| Profit view | GET /v2/accounting/profit | Get Accounting Profit |
| Settlements list | GET /v2/accounting/settlements | Get Accounting Settlements |
Recommended cadence:
- verify net balance at close,
- reconcile settlements for final accounting closure.
4. Daily reconciliation files (Broker)
For Broker companies, two CSV files are generated daily per company:
| File | Contents |
|---|---|
| Completed-operations report | The day's completed operations: per order, its side, asset, amounts, prices and results. |
| Balance snapshot | Per-user balances valued at the day's prices. |
Ask your Manteca contact about access to them.
5. Virtual Accounts settlement report
For Virtual Accounts, you can generate an on-demand CSV settlement report — a bank-statement-style list of every credit and debit across your accounts in a date range, with counterparty, E2E ID and resulting balance per row.
| Step | Endpoint |
|---|---|
| Request a report | POST /wallet/v1/stats/account-movements-report |
| Fetch status + download link | GET /wallet/v1/stats/account-movements-report/{jobId} |
See Settlement Report for the full column reference.
6. Vertical shortcuts
- From Ramps: Ramps reconciliation
- From QR Payments: Reconciliation & Reporting
- From Bill Payments: Reconciliation & Reporting
- From Broker: Execution tracking
Updated 27 days ago