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:

FlowRecommended queries
Ramps (automatic/manual)GET /v2/synthetics, GET /v2/deposits, GET /v2/withdraws
QR PaymentsGET /v2/synthetics
Bill PaymentsGET /v2/synthetics
Virtual AccountsGET /wallet/v1/transfers — filter by type=DEPOSIT (collections) or type=WITHDRAW (payouts)
BrokerGET /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:

PurposeEndpointAPI Reference
Current balancesGET /v2/user-balances, GET /v2/user-balances/USERANYIDGet User Balance
Balance movementsGET /v2/balance-activitiesGet Activities
End-of-period snapshotsGET /v2/balance-activities/snapshotsGet Users Balance Snapshots
Broker user balancesGET /broker/v1/api/balance/USERANYIDGet user balance

Balance activities fields

GET /v2/stats/balance-activities returns one record per balance movement. Key fields:

FieldDescription
externalReferenceIdYour external identifier for the originating operation
internalReferenceIdManteca's internal reference
amountTotal transaction value
balanceAmountPortion debited or credited from available balance
overdraftAmountPortion handled as operational overdraft
remainingBalanceBalance after this movement
descriptionOrigin of the movement (see values below)

description values

ValueMeaning
PAYMENT_CREATIONDebit for a QR payment
PAYMENT_CANCELLATIONCredit on QR payment cancellation or refund
PAYMENT_PARTIAL_REFUNDCredit on QR payment partial refund
BILL_PAYMENTDebit for a bill payment
BILL_PAYMENT_REFUNDCredit on bill payment refund
WITHDRAW_CREATIONDebit for an outbound withdrawal
WITHDRAW_CANCELLATIONCredit on withdrawal cancellation
WITHDRAW_COST_DEBTDebit for withdrawal network fee
WITHDRAW_COST_DEBT_REFUNDCredit on withdrawal fee refund
DEPOSIT_CREATIONCredit for an inbound deposit
ORDER_CREATIONDebit or credit from a trade order
ORDER_REVERSALDebit or credit from a trade order reversal
INTERNAL_MOVEMENTInternal balance movement between accounts
LOCK_FUNDSDebit when funds are locked
UNLOCK_FUNDSCredit 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:

PurposeEndpointAPI Reference
Portfolio summaryGET /v2/accounting/summaryGet Accounting Summary
Net positionGET /v2/accounting/net-balanceGet Accounting Net Balance
Debt ledgerGET /v2/accounting/debtGet Accounting Debt
Credit ledgerGET /v2/accounting/creditGet Accounting Credit
Profit viewGET /v2/accounting/profitGet Accounting Profit
Settlements listGET /v2/accounting/settlementsGet Accounting Settlements

Recommended cadence:

  1. verify net balance at close,
  2. reconcile settlements for final accounting closure.

4. Daily reconciliation files (Broker)

For Broker companies, two CSV files are generated daily per company:

FileContents
Completed-operations reportThe day's completed operations: per order, its side, asset, amounts, prices and results.
Balance snapshotPer-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.

See Settlement Report for the full column reference.


6. Vertical shortcuts



Did this page help you?