# Mass Payouts

The **«Mass Payouts»** section is designed for sending bulk payouts in **TRX** or **USDT TRC-20** to multiple addresses simultaneously. The feature is available in the merchant dashboard and allows mass payouts to be processed in three steps: input data, preview, confirmation and processing.

### Step 1. Input Data

In the first step, the merchant must select the payout currency and provide a recipients list with wallet addresses and payout amounts.

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

#### **Currency**

The following currencies are available for mass payouts:

* **TRX**
* **USDT TRC-20**

#### **Recipients List**

Recipients can be added in two ways.

**Manually** – to add a row, click **«+ Add recipient»**, then enter the recipient wallet address and payout amount. To remove all entries, click **«Clear»**.

**File upload** – to upload a file with the recipients list, click **«Upload file»**.

{% hint style="info" %}
Supported file formats: **XLSX**, **CSV**, **TXT**. Maximum file size – **5 MB**.&#x20;
{% endhint %}

#### **File Format Requirements**

Each row in the file must contain only two values: wallet address and amount.

**CSV and TXT**

One row = one payout. Use comma as delimiter only:

```
TXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX,10.5
```

Format: `address,amount` (no spaces and no extra columns).

**XLSX**

Use the first two columns:

* **A** – wallet address
* **B** – amount

The first row can be a header: `address`.

{% hint style="info" %}
**Check before upload:**

* the address has no extra characters or spaces;
* the amount must be greater than 0;
* use a dot for decimal values (for example, `1.25`);
* empty rows are removed.
  {% endhint %}

Once the recipients list is complete, click **«Continue»**.

### Step 2. Preview

This step displays a summary of the upcoming mass payout:

| Parameter            | Description                                             |
| -------------------- | ------------------------------------------------------- |
| **Transactions**     | Total number of recipients in the payout                |
| **Total payout**     | Total amount of funds to be sent                        |
| **goodPayments fee** | Service fee in TRX for processing the mass payout       |
| **Activation cost**  | Cost of activating new addresses in TRX (if applicable) |

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

To proceed, click **«Continue»**. To return to editing the recipients list, click **«Back»**.

### Step 3. Confirmation and Processing

In the third step, goodPayments generates a **temporary payout address** to which the merchant must transfer the required amount.

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

The following information is displayed at this step:

* **Temporary payout address** – the address to top up, with a copy button and a QR code for scanning;
* **Required top-up** – the exact amount in USDT to be sent to the temporary address;
* **Status** – the current state of the mass payout;
* **Progress** – a counter in the format `Sent: X, Failed: X, Pending: X`.

Once funds are received at the temporary payout address, the service will automatically initiate payouts to all specified addresses. The progress bar will reflect the processing status in real time.

{% hint style="warning" %}
If there are insufficient funds on the payout address, the service will display a corresponding notification indicating the amount still required.&#x20;
{% endhint %}

Once the payout is complete, click **«New mass payout»** to start a new one.

### Payout History

All mass payouts are recorded in the **«Invoices»** section – the full history of all payments and transactions.

To filter the table by mass payouts only, look for records with the address type **«Mailings»** displayed in the corresponding column.

Clicking on an **invoice ID** opens a page with detailed information about the payout:

* current invoice status and expiry details;
* expected and actually received amounts;
* to view data on each individual payout transaction, click **«View transactions»**.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://goodpayments.gitbook.io/docs/user-guide/mass-payouts.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.