View Automatic Purchases
Access prerequisites
- Permission (module):
viewGeneralJournal - License/Feature: None.
- Menu container: GENERAL → Operations group
What it is / when to use
Lists all automatic purchase orders generated by the platform — purchases of tokens, NFTs, tickets, and marketplace items. Unlike manual payments, these orders originate from an automated flow (app checkout). The operator monitors the order status and, for orders still in draft (created), can finalize or cancel them manually when the automatic flow did not close on its own.
Prerequisites
- Permission:
viewGeneralJournal(double permission — CPM enum + dynamic module in the DB). - License/Feature: None.
- Dependencies on other screens: the order must exist (generated by the app). Status actions are only available for orders in
created.
Step by step
- Go to Operations → View automatic purchases.
- Filter by type (All, NFT, Token, Marketplace) and by status (All, Charge, Cancelled, Created, Finished, In Transit). The search filters by the user's e-mail.
- For an order in Created, use check to mark it as finished or delete to cancel it.
Filters and columns
| Filter/Column | What it shows | Data source |
|---|---|---|
| Search | Local filter by buyer e-mail | userEmail (front-end filtering) |
| Type | NFT / Token / Marketplace / All | isNftBuy, isTokenBuy (neither = Marketplace) |
| Status | Order status | status (OrderStatus) |
| Date | Creation date | createdAt |
| Buyer | userEmail | |
| Method | Payment method | paymentMethod |
| Type | Purchase of tokens / NFTs / tickets / Marketplace | derived from isTokenBuy/isNftBuy/isTicketBuy |
| Token qty | Quantity of tokens/items | tokensAmount (BigNumber) |
| Amount / Currency | Total and unit | totalAmount / unit_purchased or assetId (asset name) |
| Paid? | Whether payment was confirmed (green/red) | wasPaid |
| External ID | Identifier in the ledger/provider | external_id |
Actions and modals
- Finalize (check): calls
changeOrderStatus('finished', id)on OrderService. Marks the order as finished in the backend (OrderBook/FMS). - Cancel (delete): calls
changeOrderStatus('cancelled', id). Cancels the order.
Both actions are only available for orders with status
created. There is no confirmation bottom-sheet — the action is immediate; the result is displayed via snackbar and the list is reloaded.
Business rules / caveats
Attention
- This screen is primarily for monitoring. Only intervene manually when an order is stuck in
created. - The search filter is local (over the loaded page), not a paginated query to the backend — searches by exact/partial e-mail.
- Financial values: handled as BigNumber — no rounding; check the token's decimal places.
- Idempotency: closing the order credits via FinLib;
E00021"already processed" means the order has already been settled — success, not an error. - Status APPROVED: the buyer must be
APPROVEDfor the purchase closure to credit/debit the balance.