Bank Retirer

The bank retirer receives value returned by the issuer and submits requests to remove that value from circulation.

The bank retirer can send burn requests and return available value to eligible issuers. They cannot approve their own retirement requests, create accounts, assign roles, change limits, or change setup.

Before you can complete bank retirer tasks, you must have an active retirer deposit token account and an eligible wallet. You must be a member of the Bank Retirer application group with the Burner ledger role. There must also be value (tokens) returned by a bank issuer, an eligible manager approver, and an active bank issuer account.

Typically the bank retirer completes tasks in the following order.

  1. Confirm the retirer account is active and review the total retired and balance amounts.
  2. If value has not arrived, ask the bank issuer to use Transfer to send value to this account.
  3. Select Retire Tokens, choose the manager approver, enter the quantity, and optionally add a memo.
  4. Submit the burn request and record the request ID.
  5. Wait for the bank manager to approve or reject the request.
  6. Refresh history and confirm the retirement status, balance, and total retired value.

The following tasks are typical ones that a bank retirer completes.

Retire Tokens

  1. Select Retire Tokens. The Request Burn Tokens window is displayed.
  2. Enter a Quantity and an optional Memo. If multiple eligible managers are available, select an Approver User ID.
  3. Select Request Burn. The request is sent for manager approval.

Return Value to Issuer

  1. Select Transfer for an eligible bank issuer.
  2. Select the To User ID, enter a Quantity. Optionally, select Purpose and then select one of the configured purposes.
  3. Select Transfer. The return transfer is evaluated by the active approval policy and may settle immediately or remain pending for the configured approval sequence. If approved, the value is returned to the selected issuer and the approver organization and approver user ID context used for the approval-aware transfer are displayed.

Transaction Filters

After you load records from an organization or account history, you can use the following filters to find specific transactions.

Filter Parameters
Transaction ID Enter an operation or transaction identifier.
Amount Select a comparison and enter an amount.
Balance Select a comparison and enter a balance.
Transaction Type Select a transaction type.
Initiator Enter a user or organization value.
Account ID Enter an account identifier.
Purpose/Memo Enter the text to search for.
Start Date / End Date Select the beginning and ending dates.
Selecting a transaction history row opens a read-only Transaction details window, which includes the following fields.
Section Information Displayed
Summary Transaction ID, Holding ID, Purpose/Memo, Block Number, Transaction Time, Transaction Type, Amount, and Token ID.
From Organization, User ID, and From Account ID. The From party displays - for a creation transaction.
To Organization, User ID, and To Account ID. The To party displays - for a retirement transaction.

Troubleshooting

If no returned value is available, ask the bank issuer to transfer it. If no approver is available, ask the bank administrator to verify active manager accounts and Escrow roles. If a quantity is rejected, check the balance, limits, and decimal precision. If the account is inactive, ask the bank administrator to review the account.