CRYPTOMENTS Partner Console User Guide

1 Introduction

Overview and core features of the CRYPTOMENTS Partner Console.

CRYPTOMENTS Partner Console is the partner administration console for our multi-chain stablecoin payment gateway. Partner admins use it to monitor deposits/withdrawals, manage wallets, review settlements, and configure system settings.

📊

Real-time Dashboard

See today's deposit/withdrawal volume, balances and trends at a glance.

💰

Deposit / Withdrawal

Browse deposit history, submit and approve withdrawal requests, manage whitelists.

👛

Wallet Management

Create HOT/MASTER/POOL wallets and monitor balances.

⚙️

Settings

Configure API keys, Webhooks, Telegram alerts, FX & fee policies.

⛽️

Gas Management

Review on-chain gas records and monthly invoices.

Supported Blockchain Networks

Network	Supported tokens	Gasless mechanism
BNB Smart Chain (BSC)	USDT, USDC	Relayer + one-time Approve
Polygon	USDT, USDC	Relayer + one-time Approve
TRON	USDT	Energy rental

2 Getting Started

How to sign in and set things up for the first time.

2.1 Sign In

To access the Partner Console you need the email and password issued by your administrator.

1

Open the Console

Open the Partner Console URL in your browser.

2

Enter Email / Password

Enter the email and password you were issued.

3

Remember Me (optional)

Check "Keep me signed in (7 days)" to stay signed in without re-authenticating for a week.

4

2FA (if enabled)

If 2FA (OTP) is enabled, enter the 6-digit code from your authenticator app.

✅

Forgot your password?
Click "Forgot password?" at the bottom of the sign-in screen to request a password reset.

2.2 Two-Factor Authentication (2FA)

We strongly recommend enabling 2FA (OTP). Sensitive actions such as withdrawal requests and password changes require OTP.

1

Open Settings

Go to My Account › 2FA Setup.

2

Scan the QR Code

Scan the on-screen QR code with an authenticator app like Google Authenticator or Authy.

3

Enter the Code

Enter the 6-digit code shown by your authenticator app to complete setup.

⚠️

Heads up: Without 2FA enabled, a warning banner is shown at the top of the console and some features (withdrawals, etc.) may be restricted.

3 Dashboard

The main screen showing core metrics at a glance.

The first screen you see after signing in. Monitor today's deposit/withdrawal activity, balances, and the last 7 days of transaction trends in real time.

Dashboard — today's deposits/withdrawals, available balance, 7-day trend, balance by currency

Key Metric Cards

Card	Shows	Description
Today's Deposits	Amount + count	Total deposit amount and count for today
Today's Withdrawals	Amount + count	Total withdrawal amount and count processed today
Available Balance	USD total	USD-equivalent total of all stablecoin (USDT/USDC) balances
Pending Withdrawals	Count	Number of withdrawal requests awaiting approval

7-Day Trend Chart

Visualizes daily deposit amounts and counts over the last 7 days, so you can spot volume trends quickly.

Balance by Currency

Shows held balances by currency (USDT, USDC, etc.) with network breakdown.

4 Deposit Management

Deposit history, deposit reservations, payment links, and related features.

4.1 Deposit History

Deposits › Deposit History

Browse and search every deposit received by the system.

Deposit history — search by date range, status, user ID, deposit code or TX hash

Search Filters

Date range — Start and end date
Status — DETECTED, CONFIRMING, CONFIRMED, COLLECTING, SETTLED, FAILED
User ID — Search by partner-side user ID
Deposit code / TX Hash — Search by deposit code or transaction hash

List Columns

Column	Description
Deposit code	Unique deposit identifier assigned by the system
User ID	Partner-side user ID (click to open user detail)
Time	When the deposit was detected
Network	Blockchain network (BSC, Polygon, TRON)
Method	HD wallet / external wallet / decimal match
Amount	Deposit amount + token symbol + KRW value
Status	Current processing status (color badge)
TX Hash	Transaction hash (click to open block explorer)

💡

Detail panel: Click a row to open the detail panel on the right with deposit code, fee, net amount, confirmation time, and more.

4.2 Deposit Reservations

Deposits › Deposit Reservations

Reserve a fixed deposit address for a user so incoming deposits are matched to them automatically.

💡

When to use it:
When you want to pre-assign a dedicated deposit address to a specific user. Reservations can also be created via API.

4.3 Payment Links

Deposits › Payment Links

Create one-time payment links to send to users. They can pay easily through the widget UI.

4.4 Axim Pay

Deposits › Axim Pay

Browse payments processed through the Axim Pay integration. Only visible to partners with Axim Pay enabled.

5 Withdrawal Management

Withdrawal history, withdrawal requests, and whitelist management.

5.1 Withdrawal History

Withdrawals › Withdrawal History

Browse all withdrawal transactions and handle requests, approvals, and rejections.

Withdrawal history — search by date range, status, withdrawal code or TX hash; create a withdrawal request

Search Filters

Date range — Start and end date
Status — REQUESTED, PENDING_APPROVAL, APPROVED, PROCESSING, CONFIRMED, FAILED, CANCELLED, REJECTED
Withdrawal code / TX Hash — Search by withdrawal code or transaction hash

List Columns

Column	Description
Withdrawal code	Unique withdrawal identifier assigned by the system
User ID	Partner-side user ID
Requested at	When the withdrawal was requested
Network	Blockchain network
Type	User withdrawal / API withdrawal / Manual
Amount	Withdrawal amount + token symbol + KRW value
Status	Current processing status (color badge)
TX Hash	Transaction hash

5.2 Requesting a Withdrawal

You can request withdrawals directly from the console.

1

Click "Request Withdrawal" on the Withdrawal History page

The withdrawal request modal opens.

2

Pick network and currency

Pick the blockchain network and token. The available balance is shown after selection.

3

Enter the amount

Enter the withdrawal amount. Click MAX to auto-fill the entire available balance.

4

Enter the recipient address

Whitelist mode: Pick from your registered whitelist addresses.
Manual mode: Enter the destination wallet address yourself.

5

OTP authentication and confirm

Enter your 2FA code to confirm the withdrawal request.

⚠️

Withdrawal Policy: Depending on your policy, withdrawals over a threshold automatically transition to a pending-approval state. An admin must explicitly approve or reject.

5.3 Approve / Reject Withdrawals

Withdrawals in PENDING_APPROVAL can be approved or rejected by an administrator.

1

Click a pending-approval row in Withdrawal History

The detail panel opens.

2

Click "Approve" or "Reject"

On reject, enter a reason.

3

OTP authentication

Enter the OTP code to confirm the approval or rejection.

💡

Cancel withdrawal: Withdrawals not yet broadcast to chain (REQUESTED, PENDING_APPROVAL, APPROVED, FAILED) can be cancelled with the "Cancel" button.

5.4 Whitelist

Withdrawals › Whitelist

Pre-register destination addresses that can be used for withdrawals. The whitelist helps prevent withdrawals to the wrong address.

6 Wallet Management

Create, browse and manage blockchain wallets.

6.1 Wallet List

Wallets › Wallet List

Browse all wallets registered in the system by type.

Wallets — list by type, with HOT/MASTER/POOL create buttons

Wallet Types

Type	Role	Description
HOT	Deposit wallet	Per-user deposit wallet. Received funds are swept to the MASTER wallet during the Collection process.
MASTER	Withdrawal source	The partner's main treasury wallet. Withdrawals are sent from here. Created automatically when a chain is activated.
POOL	Decimal matching	Pool wallet used by decimal-tail matching deposits.

Create a Wallet

Use the "Create HOT", "Create MASTER", and "Create POOL" buttons at the top of the page to create a new wallet. After picking a network, the wallet address is generated automatically using HD (Hierarchical Deterministic) derivation.

💡

Wallet detail: Click a wallet in the list to open the detail page — per-token balances, deposit/withdrawal history, Approve status, and more.

6.2 External Wallets

Wallets › External Wallets

Register addresses outside the system to leverage for deposit detection. Transactions sent from a registered external wallet are automatically attributed to the user as a deposit.

6.3 Transactions

Wallets › Transactions

A unified view across deposits, withdrawals, sweeps, etc. Search by user ID, wallet address, TX hash, and other filters.

7 Sub-partner Management

Sub-partner management is available only to DISTRIBUTOR-type partners.

7.1 Distributor vs Merchant

CRYPTOMENTS has two partner types:

Aspect	Distributor (DISTRIBUTOR)	Merchant (MERCHANT)
Sub-partner management	Allowed (can register distributors + merchants)	Not allowed
Fee model	parentFeeRate, maxFeeCap configurable	Only depositFeeRate applies
Revenue	Earns the spread on sub-partner transactions	Direct transactions only
Tree structure	Can nest distributors/merchants hierarchically	Leaf node (no children)
Dashboard	Sub-partner overview + revenue summary	Own transaction overview only

💡

Distributors can nest distributors: A distributor can register another distributor underneath, forming a multi-tier distribution structure (up to 5 levels). The fee spread at each level is the distributor's revenue at that level.

7.2 Sub-partner List

Sub-partners › List

Browse your registered sub-partners as a list or as a tree. Search by status, type, or partner code/name.

List View

The default list view shows your direct sub-partners as a table — partner code, name, type, status, fee rate, and more on each row.

Tree View

The tree view visualizes the hierarchy. See at a glance which merchants/distributors sit under each distributor, up to 5 levels deep.

7.3 Register a Sub-partner

Sub-partners › Register

Register a new merchant or sub-distributor. 2FA is required.

Basic Info

Field	Description	Required
Partner type	Pick MERCHANT (merchant) or DISTRIBUTOR (distributor)	Required
Partner name	Display name of the sub-partner	Required
Sign-in email	Email used by the sub-partner to sign in to the console	Required
Password	Initial sign-in password (8+ chars)	Required

Fee Setup

The fee model depends on the sub-partner's type:

When registering a Merchant (MERCHANT)

Field	Description
`depositFeeRate`	Deposit fee rate applied to the merchant (%). The spread between this rate and the parent distributor's parentFeeRate is the distributor's revenue.

When registering a Sub-distributor (DISTRIBUTOR)

Field	Description
`parentFeeRate`	Fee rate (%) the sub-distributor pays up to its parent (you) when charging its own merchants.
`maxFeeCap`	Maximum fee rate (%) the sub-distributor is allowed to set for its merchants.

⚠️

Fee-rate constraints:

minFeeRate is computed automatically: parent distributor's minFeeRate + parent's parentFeeRate
A merchant's depositFeeRate must be ≥ minFeeRate
And must be ≤ the sub-distributor's maxFeeCap
Changing a fee rate cascades minFeeRate recomputation across all sub-partners

Revenue Calculation Example

Scenario: Top-level admin → Distributor A → Merchant B

Top-level admin: minFeeRate = 0.5%
Distributor A: parentFeeRate = 0.3% (paid up to admin), minFeeRate = 0.8% (0.5 + 0.3)
Merchant B: depositFeeRate = 1.2% (effective applied fee)
Distributor A's revenue = 1.2% − 0.8% = 0.4%

On a 1,000 USDT deposit at Merchant B → Distributor A's revenue: 4 USDT

Chain Activation

Pick the blockchain networks and currencies the sub-partner will use. Activating a chain auto-creates the corresponding HD wallet.

7.4 Manage Sub-partners

Detail View

Click a sub-partner to view its details — basic info, fee setup, and a transaction summary (deposits/withdrawals/revenue).

Edit Info

Edit partner name, fee rates, and so on. Changing a fee rate cascades minFeeRate recomputation to all sub-partners.

Status Change

Change the sub-partner's status:

ACTIVE → SUSPENDED: Suspend all services for the sub-partner
SUSPENDED → ACTIVE: Re-activate suspended services

Reset Password

Reset the sub-partner's sign-in password to a temporary one. Share the issued temporary password with the sub-partner.

Delete Sub-partner

Only direct sub-partners can be deleted. 2FA is required, and all of the following must be true:

No transaction history (deposits/withdrawals)
No sub-partners of their own (must be a leaf node)

7.5 Activity Overview

Sub-partners › Activity Overview

Summary of deposit/withdrawal activity per sub-partner. Filter by period (Today / This Week / This Month).

Drill-down

Select a sub-partner to view that partner's detailed transaction history (deposits, withdrawals, ledger).

8 Gas Management

Review on-chain gas usage and monthly invoices.

8.1 Gas Records

Gas › Gas Records

Browse gas consumed by on-chain transactions (sweep, withdrawal, Approve, etc.) record by record. Shows the gas amount in the network's native token (BNB, POL, TRX) along with the USD equivalent.

8.2 Invoices

Gas › Invoices

Browse monthly gas invoices. Each invoice includes per-network gas totals, the total amount, and the issuance status.

💡

Invoice detail: Click an invoice to open the detail page, which shows per-network gas aggregates and individual transactions.

9 Settings

Manage API integrations, business policies, and account settings.

9.1 Integrations

Settings › Integrations

Manage the API keys, Webhooks, Telegram, and Axim Pay integration settings.

Integrations — settings under the API Keys, Webhook, Telegram, and Axim Pay tabs

API Keys

View your partner API Key and Secret under the API Keys tab.

🔒

Security warning: Never expose your API Key and Secret. The Secret is shown only at issuance time and cannot be retrieved afterwards.

Webhook Settings

Set the callback URL for deposit/withdrawal events under the Webhook tab.

Events such as deposit confirmation and withdrawal completion are delivered in real time to the configured URL. This is required when integrating via the API.

✅

Test delivery: After setting the Webhook URL, use the "Send Test" button to verify your endpoint receives events correctly.

Telegram Notifications

Configure the Telegram bot notifications under the Telegram tab.

1

Connect the Telegram bot

Click the displayed bot ID @CryptomentsBot, or search for the bot in the Telegram app.

2

Activate the bot

In Telegram, send the /start or /verify command.

3

Confirm notifications

Once verified, the console state changes to ON. Use the "Send Test" button to confirm.

Supported notification types:

Notification type	Description
Deposit detected (DEPOSIT_DETECTED)	When a deposit TX is detected on-chain (awaiting block confirmation)
Deposit confirmed (DEPOSIT_CONFIRMED)	When the deposit is confirmed on-chain
Large deposit (LARGE_DEPOSIT)	When a deposit exceeds the configured threshold
Withdrawal requested (WITHDRAWAL_REQUESTED)	When a new withdrawal request is received
Withdrawal approved (WITHDRAWAL_APPROVED)	When a withdrawal request is approved
Withdrawal rejected (WITHDRAWAL_REJECTED)	When a withdrawal request is rejected by an administrator
Withdrawal completed (WITHDRAWAL_CONFIRMED)	When a withdrawal is confirmed on-chain
Withdrawal failed (WITHDRAWAL_FAILED)	When an error occurs during withdrawal processing
Withdrawal cancelled (WITHDRAWAL_CANCELLED)	When a withdrawal request is cancelled

⚠️

Operational recommendation: For stable operation and fast incident response, keep Telegram bot notifications ON. Insufficient-balance and low-gas alerts in particular are essential to prevent withdrawal-service outages.

Axim Pay

Configure the Axim Pay payment integration under the Axim Pay tab. Shown only to partners with Axim Pay enabled.

9.2 Business Settings

Settings › Business Settings

FX Policy

Configure how KRW exchange rates are displayed under the FX Policy tab.

Live market rate — Apply Bithumb's live market rate automatically.
Manual — Set the rate yourself.

Fee Settings

Review your deposit fee rates under the Fees tab.

Withdrawal Policy

Configure withdrawal approval behavior under the Withdrawal Policy tab.

Mode	Description
Auto approval	All withdrawal requests are processed automatically.
Conditional manual approval	Only withdrawals above the configured USDT threshold require manual approval.

💡

Security recommendation: We strongly recommend "Conditional manual approval" mode to prevent large-withdrawal incidents.

9.3 My Account

Settings › My Account

Basic Info

View basic account info — partner code, type (merchant/distributor), partner name, status, and so on.

Change Password

Change your password by entering the current password and a new one. Passwords must contain 8+ characters, mixing letters, digits, and special characters. OTP authentication is required.

2FA Settings

Manage enable/disable of 2FA (OTP). See 2.2 2FA Setup for detailed setup steps.

10 Status Flow

State transitions during deposit and withdrawal processing.

10.1 Deposit Status Flow

DETECTED → CONFIRMING → CONFIRMED → COLLECTING → COLLECTED → SETTLED

Branch: FAILED

Status	Display name	Description
`DETECTED`	Detected	A deposit transaction was detected on-chain.
`CONFIRMING`	Confirming	Waiting for block confirmations.
`CONFIRMED`	Confirmed	The required confirmation count has been met.
`COLLECTING`	Sweeping	Moving funds from the HOT wallet to the MASTER wallet.
`COLLECTED`	Swept	The sweep to the MASTER wallet is complete.
`SETTLED`	Settled	Settlement processing is complete.
`FAILED`	Failed	An error occurred during processing.

10.2 Withdrawal Status Flow

REQUESTED → PENDING_APPROVAL → APPROVED → PROCESSING → BROADCASTING → CONFIRMED

Branches: REJECTED FAILED CANCELLED

Status	Display name	Description
`REQUESTED`	Requested	The withdrawal request was received.
`PENDING_APPROVAL`	Pending approval	Waiting for manual administrator approval.
`APPROVED`	Approved	The withdrawal is approved and awaiting processing.
`PROCESSING`	Processing	The withdrawal transaction is being prepared.
`BROADCASTING`	Broadcasting	The transaction has been broadcast to the network.
`CONFIRMED`	Confirmed	The transaction has been confirmed on-chain.
`REJECTED`	Rejected	An administrator rejected the withdrawal.
`FAILED`	Failed	An error occurred during withdrawal processing.
`CANCELLED`	Cancelled	The withdrawal was cancelled.

11 Frequently Asked Questions (FAQ)

Common questions and answers about using the Partner Console.

{{ faq.q[lang] }} ▼