Help Center/Economic Sovereign Wallet & Yields/Create a manual wallet adjustment (credit or debit)
Economic Sovereign Wallet & Yields•Last updated: 2026-10-20•6 min read

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?

Ask AI Copilot

Step-by-Step Procedure

1

Open Wallet Adjustments

In the admin sidebar open "Finance & Payments" and click "Wallet Adjustments" (page title "Wallet Balance Manual Adjuster").

2

Start the form

Click "Create Adjustment". The dialog "Create Wallet Adjustment" opens.

3

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.

4

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.

5

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.

6

Explain the change

Fill "Detailed Reason & Justification" (required, at least 5 characters). Optionally add "Reference ID / Ticket (Optional)" and "Evidence / Attachment URL (Optional)".

7

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."

Expected Operational Outcome

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

Symptom: "Insufficient wallet balance for debit..."
Likely Cause: The debit would take the balance below zero.
Resolution: Lower the amount or choose Credit; the preview shows the resulting balance first.
Symptom: "A detailed adjustment reason (at least 5 characters) is mandatory."
Likely Cause: The reason is empty or too short.
Resolution: Write a fuller justification.

Was this guide helpful?

Help us refine our platform documentation