> For the complete documentation index, see [llms.txt](https://docs.inqud.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.inqud.com/mass-payout/how-it-works.md).

# 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="/files/ooNamjs3x9HwddGSGBSn" 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="/files/AwLwoPjduxhjp56d8C9T" 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="/files/pA3dDUwiqBmUnWxItaa9" 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="/files/ovnXz8IzL2UW6vc7HB6A" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ZB5TCQOx0NBDeCYrkKom" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/FuUP9LaiTtbI8KOM2mAd" 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="/files/ru2R1LfK4OPkPw33btQa" alt=""><figcaption></figcaption></figure>
