Skip to main content

Channel Management Overview

The Channel Management feature is used to manage the platform's payment channels, including channel configuration, balance management, and service binding.

Feature Overview​

Channel Management includes the following features:

  • Channel List: View all payment channels
  • Channel Configuration: Edit channel parameters and limits
  • Channel Services: Manage service types supported by channels
  • Balance Management: View channel balances and transaction history
  • Channel Status: Enable / Disable channels

Page Description​

Channel List Page​

Path: Channel → ChannelList

Main Fields:

FieldDescription
Channel IDUnique identifier
Channel NameDisplay name of the channel
Channel TypeUpstream channel provider type
CurrencySupported currency types (CNY, USDT, VND, etc.)
BalanceCurrent available balance
StatusActive / Disabled

Main Features​

1. Channel List (ChannelList)​

View all configured payment channels.

Key Information:

  • Channel basic information
  • Current balance status
  • Channel operational status

Operations:

  • Edit channel configuration
  • Enable / Disable channel
  • View channel details

2. Channel Services (ChannelService)​

Path: Channel → ChannelService

Manage service types supported by channels.

Features:

  • View list of services supported by a channel
  • Add new services to a channel
  • Edit service configuration
  • Remove services

Service Binding Logic:

  • One channel can support multiple services
  • One service can be bound to multiple channels
  • Merchants call by service ID, and the system automatically routes to an available channel

[!NOTE] Service binding determines which channels a merchant can use. Only channels bound to the corresponding service can process orders for that service.

3. Channel Details (ChannelDetail)​

View detailed information for a single channel:

Includes:

  • Channel basic configuration
  • API configuration information
  • Limit settings
  • Rate configuration
  • Balance status

4. Channel Balance Records (ChannelBalanceRecord)​

Path: Channel → ChannelBalanceRecord

View the balance change history for a channel.

Record Information:

  • Change time
  • Change type (Deposit / Payout / Adjustment / Manual Supplement, etc.)
  • Change amount
  • Balance before and after the change
  • Associated order number
  • Remarks

Filter Function:

  • Filter by time range
  • Filter by change type
  • Filter by channel

[!TIP] Channel balance records help track fund flows and troubleshoot balance anomalies.

Channel Type Descriptions​

Deposit Channel​

Channels used to process deposit (collection) transactions.

Characteristics:

  • Receive customer payments
  • Balance increases
  • Requires integration with upstream deposit interface

Payout Channel​

Channels used to process payout (withdrawal) transactions.

Characteristics:

  • Make payments to users
  • Balance decreases
  • Requires integration with upstream payout interface

Bidirectional Channel​

Channels that support both deposits and payouts.

Channel Status Management​

Status Types​

1. Active (Status = 1)

  • Channel is operating normally
  • Can process orders

2. Disabled (Status = 0)

  • Channel is suspended
  • No new orders will be assigned
  • Existing orders can continue processing

Disabling Scenarios​

It is recommended to disable a channel in the following situations:

  • Channel maintenance or upgrade
  • Insufficient balance for payouts
  • Upstream channel failure
  • During rate adjustment

[!WARNING] Before disabling a channel, please confirm there are no large numbers of in-progress orders to avoid business impact.

Channel Limit Settings​

Limit Types​

Deposit Limits:

  • Minimum amount per transaction (payment_lower_bound)
  • Maximum amount per transaction (payment_upper_bound)

Payout Limits:

  • Minimum amount per transaction (payout_lower_bound)
  • Maximum amount per transaction (payout_upper_bound)

Limit Rules​

  • Limits are stored in "cents" and divided by 100 for display
  • 0 means no limit
  • The order amount must be within the limit range to use the channel

Example:

payment_lower_bound = 10000  -> Minimum 100
payment_upper_bound = 5000000 -> Maximum 50,000

Editing Channel Configuration​

Click the "Edit" button in the channel list to modify:

Basic Information:

  • Channel Name
  • Channel Description

Limit Settings:

  • Deposit / Payout per-transaction limits

API Configuration:

  • API Key
  • Callback URL
  • Other channel-specific configurations

Rate Configuration:

  • Channel cost rate
  • Rate type

[!CAUTION] Modifying API configuration may cause channel call failures. Please verify in a test environment before applying to production.

FAQ​

Q: How to determine if a channel is working properly?​

A: You can check through the following methods:

  1. Check if the channel status is "Active"
  2. Review recent order records
  3. Check channel balance change records
  4. Use the operation tools to create a test order

Q: What to do when channel balance is insufficient?​

A:

  1. Contact the upstream channel to replenish balance
  2. Temporarily disable the channel to avoid order failures
  3. Adjust the merchant's channel routing strategy

Q: How to add a new service to a channel?​

A: Go to the "Channel Services" page, select the channel and the service you want to add, and create the service binding.

Q: How long does it take for channel edits to take effect?​

A: Configuration changes take effect immediately and apply to newly created orders.