Skip to main content

Agent Management

The Agent Management feature is used to manage the platform's agent system, including agent profile maintenance, rate configuration, and service management.

Feature Overview​

Agent Management includes the following features:

  • Agent List View: View all agent information
  • Add Agent: Create a new agent
  • Edit Agent: Modify agent profiles and rates
  • Service Configuration: Set agent service rates
  • Agent Hierarchy: Support multi-level agent structures

Page Description​

Agent List Page​

Path: Agent → Agent

Main Fields:

FieldDescription
Agent IDUnique identifier
Agent NameDisplay name of the agent
EmailAgent contact email
Parent AgentParent agent ID (supports multiple levels)

Filter Function​

  • Agent ID Filter: Supports multi-select to view multiple agents simultaneously
  • Supports searching by agent ID and name

Main Operations​

1. Add Agent​

Click the "Add Agent" button in the upper right corner of the page:

Required Fields:

  • Agent ID (unique identifier)
  • Agent Name
  • Email
  • Parent Agent (optional, used to establish agent hierarchy)

Rate Configuration: When creating an agent, you need to configure the agent's service rates, including:

  • Select applicable services
  • Set rate type: Fixed Fee / Per-mille Rate
  • Set rate value

[!NOTE] Agent rates affect the final rate calculation for their subordinate merchants. The system automatically calculates the difference between the agent rate and the merchant rate as the agent's profit.

2. Edit Agent Profile​

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

  • Agent Name
  • Email
  • Agent service rates

3. View Agent Services​

Expand the collapsible row in the agent list to view the agent's service rate configuration:

Service Information:

  • Service Name
  • Rate type and value
    • Fixed Fee: Displayed as "X per transaction"
    • Per-mille Rate: Displayed as "X ‰"

Agent Rate Details​

Rate Types​

1. Fixed Fee (charge_type = 1)

  • A fixed amount is charged per transaction
  • Display unit: per transaction
  • Example: 5 per transaction

2. Per-mille Rate (charge_type = 2)

  • Charged based on a per-mille ratio of the order amount
  • Display unit: ‰ (per mille)
  • Example: 5 ‰ = 0.5%

Rate Calculation Logic​

Agent Profit = Merchant Rate - Agent Rate

Example:

  • Agent Rate: 3 ‰
  • Merchant Rate: 5 ‰
  • Order Amount: 10,000
  • Agent Profit: (5 - 3) × 10 = 20

[!TIP] When setting agent rates, ensure the agent rate is lower than their subordinate merchants' rates; otherwise, the agent will have no profit.

Agent Hierarchy​

The system supports multi-level agent structures:

Master Agent (A)
  ├─ Level 1 Agent (B)
  │   ├─ Merchant 1
  │   └─ Merchant 2
  └─ Level 1 Agent (C)
      └─ Level 2 Agent (D)
          └─ Merchant 3

Hierarchy Rules:

  • The parent agent's rate must be lower than that of subordinate agents/merchants
  • Each agent can have multiple subordinate agents or merchants
  • Agent IDs are used to identify hierarchy relationships

Agent Channels and Services​

Agent Channel Table (AgentChannelTable)​

View the payment channel configurations available to an agent.

Agent Service Table (AgentServiceTable)​

View the agent's service rate details.

FAQ​

Q: How to set reasonable agent rates?​

A: Agent rates should:

  • Be lower than merchant rates to ensure profit margin
  • Consider market competitiveness
  • Set tiered rates based on agent level

Q: Can agent rates be modified at any time?​

A: Yes, but modifications only take effect for new orders and do not affect completed orders.

Q: Can a merchant belong to multiple agents?​

A: No, each merchant can only belong to one direct parent agent.

Q: How to view an agent's profit?​

A: You can view the agent's order volume and rate difference through order records and statistical reports to calculate profits.