Create a manual wallet adjustment (credit or debit)
Use "Create Adjustment" to credit or debit a member wallet with a recorded reason. Small adjustments execute at once; amounts of 10,000 or more wait for a second administrator.
Have questions or need step-by-step guidance on this topic?
Step-by-Step Procedure
Open Wallet Adjustments
In the admin sidebar open "Finance & Payments" and click "Wallet Adjustments" (page title "Wallet Balance Manual Adjuster").
Start the form
Click "Create Adjustment". The dialog "Create Wallet Adjustment" opens.
Choose the member and asset
Enter the member in "Target Member / DID" (for example did:i8:human:... or a user ID) and pick "Asset / Currency": I8I, I8X, USDT or CREDITS.
Set direction, amount and type
Pick "Direction" (Credit (+) or Debit (-)), type the "Amount" (minimum 1) and choose "Operation Type": System Correction, Refund, Reward Adjustment, Referral Adjustment, Migration Adjustment or Reconciliation.
Check the Balance Impact Preview
Wait for the "Balance Impact Preview" box to show "Current Balance", "Adjustment" and "New Balance". If it says "Would be refused", read the red message under it before going on.
Explain the change
Fill "Detailed Reason & Justification" (required, at least 5 characters). Optionally add "Reference ID / Ticket (Optional)" and "Evidence / Attachment URL (Optional)".
Confirm and submit
Tick the confirmation ("I confirm that this adjustment is verified and supported by audit evidence...") and click "Execute Adjustment". A green notice reports either "Adjustment successfully executed in sovereign ledger." or "High-value adjustment queued for dual-approval."
The adjustment appears in the table: status EXECUTED with the balance before and after, or PENDING_APPROVAL if the amount is 10,000 or more.
Troubleshooting & Failure Modes
Was this guide helpful?
Help us refine our platform documentation