# How It Works

### **1. Preparing the CSV file**

On the **Mass payout** page, click **Download template** to get the CSV file structure.\
This template defines the exact fields the system expects.

⚠️ It is important to follow both the **order** and the **number** of columns.

Example below. &#x20;

<table data-header-hidden><thead><tr><th valign="top">cryptoAddress</th><th valign="top">cryptoCurrency</th><th valign="top">amount</th><th valign="top">clientOrderId</th><th valign="top">comment</th></tr></thead><tbody><tr><td valign="top">cryptoAddress</td><td valign="top">cryptoCurrency</td><td valign="top">amount</td><td valign="top">clientOrderId</td><td valign="top">comment</td></tr><tr><td valign="top">TFjyAJ2z93cKjHWbKj57ECQm7aHAdJ3ut9</td><td valign="top">TRON_USDT</td><td valign="top">21.501</td><td valign="top">someunique1</td><td valign="top">salary John</td></tr></tbody></table>

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2F8VYj8lkJRsd9fk1kJQtf%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-10-22%20%D0%B2%2023.58.35.png?alt=media&#x26;token=333b6e07-877c-4bdf-a99b-d8559faa9ed7" alt=""><figcaption></figcaption></figure>

### **2. Creating a Batch**

To start a new Mass payout:

1. Click **Create Mass payout**.
2. Upload the prepared CSV file using **Browse** or drag-and-drop.
3. Optionally specify:
   * **Name** – e.g. *“September salaries”*
   * **Client Order ID** – a unique internal identifier for the batch.\
     (These fields are optional but help identify the batch later.)
4. Click **Upload**.

After upload, the system automatically creates a **Batch** containing all the orders from the CSV file.

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2FdftMF1tTpphKxLyH53aW%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-10-22%20%D0%B2%2023.59.59.png?alt=media&#x26;token=d0705f0b-beec-4821-a45c-335eecaf95d7" alt=""><figcaption></figcaption></figure>

### **3. Validation**

Each order in the Batch undergoes a series of validation checks, including:

* Matching currency to the selected blockchain.
* Checking payout limits.
* Verifying available balance.
* Validating amount formats and precision.

Optional fields can also be included per order:

* **Client Order ID (CID)**
* **Comment** (e.g. *“Payment to Max”* or *“Refund for cherries”*).

If all checks are passed, the order receives the status **READY TO PROCESS**.\
If validation fails, it is marked as **REJECTED**, and the reason appears in the order details.

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2FUmhKxbYKmxCc19UJGpup%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-10-23%20%D0%B2%2000.03.16.png?alt=media&#x26;token=f99d959c-e095-44d9-94c3-e8d483312ae0" alt=""><figcaption></figcaption></figure>

### **4. Managing a Batch**

All batches are listed in the **Mass payouts** table.\
Click **See details** to view all orders inside a Batch.\
Click an individual order to open its detailed information.

The top of the Batch view displays a **summary**, including:

* Creation date
* Total number of orders
* Current status

In the **Estimated to Pay** block, total payout amounts are displayed by currency, for example:

* 20 USDT
* 0.5 TRX
* 50 BTC

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2F3KkMafEsZAWHZoerDckP%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-10-23%20%D0%B2%2000.10.48.png?alt=media&#x26;token=45c35073-9c80-4e88-a6ee-c1f6a9091348" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2F2FKU0ulvXmeb5xucHMgE%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-10-23%20%D0%B2%2000.12.04.png?alt=media&#x26;token=9bce5ab1-f9c5-4c55-a4bc-27d3c34ec0b7" alt=""><figcaption></figcaption></figure>

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2FqIPqVvM3Q7EfD5bVWLGX%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-10-23%20%D0%B2%2000.12.56.png?alt=media&#x26;token=8095fd5c-1246-4e62-b90e-f812e5e62007" alt=""><figcaption></figcaption></figure>

### **5. Approving payouts**

Once all orders are validated and reviewed:

1. Click **Approve**.
2. A sidebar will appear requesting **OTP codes** for confirmation.
3. After successful confirmation, the Batch begins processing — all **READY TO PROCESS** transactions are submitted to the blockchain.

<figure><img src="https://2493659114-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MVvChLJdAqFu9uz7E-7%2Fuploads%2FvKtfZ2XehL3fp5iMzIzF%2F%D0%A1%D0%BD%D0%B8%D0%BC%D0%BE%D0%BA%20%D1%8D%D0%BA%D1%80%D0%B0%D0%BD%D0%B0%202025-10-23%20%D0%B2%2000.13.48.png?alt=media&#x26;token=fa5bd13a-94b1-4976-a502-581add76b845" alt=""><figcaption></figcaption></figure>
