# Onboarding Sub-Agents

## Sub-Agent Registration

You are allowed to create one sub-agent per site.

To initiate the process, click the <kbd>+ Create</kbd> button located in the top-right corner of the page:

[`https://my.nexusggr.com/app/agents`](https://my.nexusggr.com/app/agents)

<table><thead><tr><th width="175">Field</th><th>Overview</th></tr></thead><tbody><tr><td>Parent Agent</td><td>The agent the new sub-agent belongs to: your own account or one of the agents under you.</td></tr><tr><td>Agent Code</td><td>A unique identifier used by the agent to log into the API panel. Letters and numbers only; click <kbd>Check</kbd> to make sure it is not taken.</td></tr><tr><td>Agent Name</td><td>The agent’s display name.</td></tr><tr><td>Password</td><td>The agent’s login credentials.</td></tr><tr><td>Percent</td><td>Displays the revenue share for the parent agent’s account.</td></tr><tr><td>Memo</td><td>A note about the agent, shown as Agent Memo in the agent list.</td></tr><tr><td><a href="#agent-type">Agent Type</a></td><td>The dropdown menu provides various options.</td></tr><tr><td><a href="#api-type">API Type</a></td><td>Specifies the method used for handling player funds and game sessions. </td></tr><tr><td><a href="#site-endpoint">Site Endpoint</a></td><td>Defines the agent's backend callback URL used to handle requests from the <code>/gold_api</code> endpoint</td></tr></tbody></table>

### Agent Type

* **Point Manager**:\
  The <kbd>Point Manager</kbd> role is responsible for creating sub-agents and allocating API points to their downline. However, this role does not have access to operate or manage the casino site.
* **Both Manager**:\
  The <kbd>Both Manager</kbd> role combines the responsibilities of both the Point Manager and Site Manager. This role can create sub-agents, allocate API points to the downline, and manage casino site operations, offering full access to both agent network management and casino operations.
* **Site Manager**:\
  The <kbd>Site Manager</kbd> role is focused solely on operating the casino site. While this role can manage site operations, it does not have the ability to create sub-agents or manage the agent network.

### API Type

* &#x20;[<kbd>**Seamless**</kbd>](https://my.nexusggr.com/app/docs/getting-started/api-types/seamless)\
  The player’s balance remains in the casino wallet. The system communicates directly with the game provider during gameplay to update the balance in real-time without requiring manual transfers.
  * Example: When a player starts a game, the balance is checked and updated directly from the casino wallet without moving funds.
* &#x20;[<kbd>**Transfer**</kbd>](https://my.nexusggr.com/app/docs/getting-started/api-types/transfer)\
  The player’s balance is transferred from the casino wallet to the game provider's wallet when the game starts, and any winnings or remaining balance are transferred back when the session ends.
  * Example: When a player launches a slot game, 100 USDT is deducted from the casino wallet and moved to the game wallet. After the session, the remaining balance and winnings are transferred back to the casino wallet.

### Site Endpoint

The Site Endpoint is used exclusively for the <kbd>Seamless API</kbd>. \
This allows the system to communicate with the agent’s platform for tasks such as balance updates, game results, and transaction handling.

* Example: When a player completes a bet, the system sends a `/gold_api` request to the specified Site Endpoint to update the player’s balance and record the game outcome.

> **Important:** When entering the Site Endpoint on the API Settings page, ensure that it is an `https` domain and does not include `/gold_api` at the end, as `/gold_api` will be appended automatically when sending API requests.

Please note that the API panel is limited to creating sub-agents only.

To create user accounts in Transfer mode, please utilize the `user_create` API request.

## Deposit & Withdrawal

To deposit or withdraw API balance to a sub-agent, click the sub-agent’s row in the agent list and choose <kbd>Exchange</kbd> in the menu that opens. In the **Agent Exchange** dialog, enter the amount in **Balance**, choose **Deposit** or **Withdraw** in **Type**, and click <kbd>Confirm</kbd>.

<figure><img src="https://my.nexusggr.com/assets/docs/img/agents-menu-exchange.png" alt="The menu of a sub-agent’s row on the Agent Manage page, with Exchange marked" width="776" height="488"><figcaption><p>Agent Manage</p></figcaption></figure>

## **Agent Jackpot Config**

To set the Agent Jackpot, click the agent’s row and choose <kbd>Jackpot</kbd> in the menu. The settings open in the **Agent Jackpot Config** dialog.

<figure><img src="https://my.nexusggr.com/assets/docs/img/agents-menu-jackpot.png" alt="The menu of a sub-agent’s row on the Agent Manage page, with Jackpot marked" width="776" height="488"><figcaption><p>Agent Manage</p></figcaption></figure>

## **Deleting an Agent**

To delete an agent, click its row, choose <kbd>Delete</kbd>, the last item in the menu, and confirm.

> **Warning:** Before deleting a sub-agent, ensure that all their balance is transferred to your main account, *as any remaining balance will be **lost upon deletion**.*