Documentação

English

Português
Español

English

Português
Español

Appearance

Token Deposits ​

Access requirements

  • Permission (module): sendBalance + feature ADMIN_BALANCE_CONTROL
  • User status: APPROVED
  • Menu container: GENERAL → Users group → User list → eye icon → General tab → balance card → Credit button

What it is / when to use ​

The Credit balance action (manual token deposit) allows the administrator to deposit tokens directly into a user's balance from the BackOffice. Use when:

  • An on-chain deposit was detected on the blockchain but was not automatically processed by the system (watcher failure, sync issue).
  • A refund or contractual credit needs to be granted manually.
  • Support identified a balance inconsistency and needs to correct it with evidence.

Transaction hash security (idempotency) ​

The Transaction hash field is the main security mechanism for this operation. By providing the blockchain txHash:

  • The system ensures that that hash can only be credited once.
  • Attempts to reprocess the same hash are automatically blocked (E00021 — already processed).
  • The hash is linked to the entry in the user's transaction history for future auditing.

Always provide the real txHash of the transaction. For manual credits without a blockchain origin (e.g.: bonuses, compensation), use a unique and descriptive identifier in the reference field.

How to use ​

  1. Open User details and access the balance card on the General tab.
  2. Click Credit (visible only with sendBalance + ADMIN_BALANCE_CONTROL).
  3. Select the currency/token to be credited.
  4. Enter the amount (treated as BigNumber — respect the token's decimal places).
  5. Enter the blockchain transaction hash (or a unique identifier for manual credits without an on-chain origin).
  6. Confirm the operation.
FieldDescriptionRequired
Token / CurrencyCrypto to be credited (e.g.: BTC, ETH, tBRL, tenant token)Yes
AmountQuantity to credit (BigNumber, token decimal places)Yes
Transaction hashtxHash of the blockchain operation or unique reference IDYes
NoteReason/context for the audit recordRecommended

Effects on the system ​

  • The amount is immediately added to the user's available balance for the selected token.
  • A CREDIT type entry is recorded in the History → Transactions tab.
  • The hash is marked as processed — resubmission with the same hash returns E00021 (treat as success, do not retry).

No automatic rollback

Manual credits move real balances. Verify the token, amount, and hash before confirming. To undo, a Manual debit of the same amount with a reference to the original credit will be required.