Manual Payments (Dashboard)
Access prerequisites
- Permission (module):
viewPayments - License/Feature: None.
- Menu container: GENERAL → Dashboard group
What it is / when to use
Analytical panel (read-only) for the manual payments/deposits flow — those in which the customer pays via PIX or TED to purchase Tokens or NFTs. Use it to monitor volume and ticket size of manual deposits, and the breakdown by payment method and type of asset acquired.
Prerequisites
- Permission:
viewPaymentsregistered for the operator role (dual permission — CPM enum on the backend + dynamic module in the DB). - License/Feature: None.
- Dependencies on other screens: Data comes from processed payments; the panel reflects what already exists in the deposit history.
Step by step
- Go to the Dashboard → Manual Payments menu.
- Wait for the page to load (the panel fetches the summary via
DepositsService.getDepositsDashboard). - Read the summary cards and the charts below.
Filters and columns
This is a view-only screen — there are no filters or editable fields. The indicators are:
| Indicator / Chart | What it shows | Data source |
|---|---|---|
| Number of payments | Total manual deposits in the period | summary from the deposits dashboard endpoint (FMS-PaymentController) |
| Number of Token / NFT purchases | How many deposits resulted in a Token vs NFT purchase | totalTokenBuy / totalNFTBuy |
| Total in Tokens / NFTs | Aggregate value by asset type | summary |
| Total payments | Total amount deposited | summary |
| Payment type (pie chart) | PIX × TED ratio | totalPix / totalTED |
| Tokens vs NFT (pie chart) | Token × NFT purchase ratio | totalTokenBuy / totalNFTBuy |
| Payment history (bar chart) | Total per month, ordered chronologically | paymentHistory, grouped by creation month |
Business rules / considerations
Attention
- When there is only a single month of history, the panel injects a zero-value data point for the previous month solely to give the chart a baseline — this is a display artifact, not a real payment.
- Error ≠ zero: if the query fails, the panel shows an error page. This indicates service unavailability, not the absence of payments.
- Financial values: totals are derived from monetary values (
BigNumberon the backend); the panel converts them for chart display. Use as an analytical view, not as an accounting close.