Balance Details
Understanding balance locks and movements
Balance Details
The balance detail view shows comprehensive information about an account's balance, including locks and movements. This guide explains how to understand and use this information.
Accessing Balance Details
- Navigate to the Balances list
- Click on any balance row
- The balance detail panel opens
Balance Summary
The top section shows current balance information:
| Field | Description |
|---|---|
| Account ID | Unique account identifier |
| Organization | Owning merchant or organization |
| Currency | Token/currency |
| Network | Blockchain network |
| Ledger Balance | Internal accounting balance |
| On-Chain Balance | Actual blockchain balance |
| Locked Balance | Reserved funds |
| Available Balance | Ledger minus locked |
Balance Locks
Locks reserve funds for pending operations. View locks in the Locks tab.
Understanding Locks
| Field | Description |
|---|---|
| Lock ID | Unique identifier for the lock |
| Amount | Amount of funds locked |
| Reason | Why the funds are locked |
| Created | When the lock was created |
| Status | Active or Released |
Common Lock Reasons
| Reason | Description |
|---|---|
| Pending Settlement | Funds reserved for merchant settlement |
| Pending Withdrawal | Funds reserved for withdrawal |
| Trading Lock | Funds reserved for trading operation |
| Compliance Hold | Funds held for compliance review |
Lock Lifecycle
Created → Active → Released (funds available)
or
Canceled (lock removed without action)Balance Movements
Movements show all transactions affecting the balance. View in the Movements tab.
Understanding Movements
| Field | Description |
|---|---|
| Movement ID | Unique identifier |
| Type | Credit or Debit |
| Amount | Movement amount |
| Direction | In or Out |
| Status | Pending, Completed, Failed |
| Reference | Related transaction or operation |
| Date | When the movement occurred |
Movement Types
| Type | Description |
|---|---|
| Credit | Funds added to account |
| Debit | Funds removed from account |
Movement Statuses
| Status | Description |
|---|---|
| Pending | Movement in progress |
| Completed | Movement finalized |
| Failed | Movement could not complete |
Viewing Lock Details
Click on any lock to see:
- Full lock information
- Related transaction
- Lock history
- Release conditions
Viewing Movement Details
Click on any movement to see:
- Complete movement record
- Related payment or settlement
- Blockchain transaction (if applicable)
- Timing information
Reconciliation
Use balance details to reconcile accounts:
- Compare ledger to on-chain — Identify differences
- Review pending locks — Understand reserved funds
- Trace movements — Follow transaction flow
- Identify issues — Find stuck or failed operations
When Balances Don't Match
If ledger and on-chain differ significantly:
- Check for pending movements (may be in transit)
- Look for failed movements that need retry
- Review recent activity for anomalies
- Report persistent discrepancies for investigation
Common Tasks
Finding a Stuck Payment
- Open the balance for the receiving account
- Go to Movements tab
- Look for movements with status "Pending"
- Check the related payment/settlement
Understanding Available Funds
- Note the Ledger Balance
- View the Locks tab
- Sum up active locks
- Available = Ledger - Locked
Tracing a Transaction
- Find the balance for the account
- Go to Movements tab
- Filter by date range or reference
- Click on the movement to see details
Permissions
| Role | View Balance Details |
|---|---|
| Super Admin | Yes |
| Admin | Yes |
| Payment Ops | Yes |
| Compliance Ops | Yes |
| CS Ops | Yes |
| Finance Ops | Yes |
| View Only | Yes |
Related Topics
- Balances — Balance list view
- Settlements — Settlement transactions
- Proxy Wallets — Wallet operations
Updated 4 months ago