EasyAPI
Redeem code management

Admin Guide

Redeem code management

Generate and manage quota redeem codes in bulk

Redeem codes are used for promotional giveaways or for users to top up quota themselves. Users redeem codes in the redeem code section of `/console/wallet`. Admins generate and manage codes in bulk through admin APIs such as `POST /api/redeem_code`; the web admin page is not available yet.

easyapi.com/console/wallet (user redemption)
Add redeem codeCopy selected codes to clipboardClear invalid codesKeyword (ID or name)SearchReset
IDNameStatusQuotaCreated atExpires atRedeemer IDActions
☐101Promo giveaway - MarchUnused50002026-06-012026-12-31—View · Copy · Edit · Delete
☐88Beta compensationUsed10002026-05-10—2View · Copy · Edit · Delete

Showing 1–10 of 214 · 10 per page

Redeem code list example: bulk actions, search, and pagination

Generate redeem codes in bulk

Open the generate dialog

  1. On the redeem code list page, click “Add redeem code”
  2. In the dialog, enter the batch name, quantity, quota, and other parameters
  3. You can also edit an existing record: click “Edit” on the row or call GET /api/redeem_code/{id}

Set generation parameters

ParameterDescription
name · NameBatch name or prefix to identify codes in the list
count · QuantityNumber of redeem codes to generate in one batch
quota · QuotaQuota value each redeem code grants
expired_time · Expires atOptional; the status changes to Expired once it passes
status · StatusNew codes are enabled by default; you can disable them up front

Generate codes

  • Click “Generate” to submit POST /api/redeem_code
  • The system generates a unique 32-character key for each record and writes it to the redemption table
  • The list is returned page by page from GET /api/redeem_codes by default; after a user redeems a code, used_user_id and redeemed_time are updated
  • For user-side redemption, see /console/wallet and the Quota and top-up guide

Export codes

  • After generation, copy a single key from the results area or use “Copy selected codes to clipboard”
  • Use “Copy” on a row to quickly copy one full redeem code
  • Export the key list as a text file for promotional distribution or email campaigns
  • Redeem code keys carry quota value; distribute them through secure channels and never commit them to a public code repository

List fields and actions

ColumnFieldDescription
IDidRedeem code record ID
NamenameBatch or purpose name for easy identification
StatusstatusUnused / Used / Disabled / Expired
QuotaquotaAmount of quota credited after a successful redemption
Created atcreated_timeGeneration timestamp
Expires atexpired_timeCodes cannot be redeemed after expiry; leave empty for no expiry
Redeemer IDused_user_idID of the user who redeemed the code, once used
  • Add redeem code (POST /api/redeem_code): Opens the generate dialog to create redeem codes in bulk
  • Copy selected to clipboard: Select multiple rows to copy their full keys (32 characters)
  • Clear invalid codes (DELETE /api/redemption/invalid): Deletes used, expired, or disabled records
  • Search (GET /api/redeem_codes?keyword=): Filter by ID or name keyword
  • View (GET /api/redemption/{id}): Shows redeem code details and the full key
  • Copy: Copies a single redeem code key to the clipboard
  • Edit (PUT /api/redeem_code/{id}): Changes the name, quota, expiry time, or status
  • Delete (DELETE /api/redemption/{id}): Deletes a single record (irreversible)

To show this in the admin sidebar, go to Profile settings → Sidebar modules and enable sidebar_modules.admin.redemption.