# Mass Payouts

## **What is Mass Payouts?**

The Mass Payouts feature allows you to send multiple cryptocurrency payments in a single batch. Instead of processing each payout individually, you can simply upload a CSV file containing all the payout details, and our platform will handle the rest - validating the data, calculating fees, and executing transactions seamlessly.

## **How It Works**

1. **Download the CSV template** from the Mass Payouts page in the user interface of your account
2. **Fill in the required details**, such as recipient addresses, amounts, and payout currencies
3. **Upload the completed CSV** to the platform
   1. When uploading the file, pay your attention to the "**Absorb fees**" toggle in the user interface
      1. If **FALSE**, both Txn service and network fees are deducted from the transaction amount
      2. If **TRUE**, both fees are deducted from your account balance instead
4. **Our system validates** the data
5. **Review and confirm** the batch before processing
6. **Our system executes** the payouts automatically

## CSV Template

{% file src="/files/fx2PVjgAwUfOtdGTuVFq" %}

## How to Populate the Mass Payout CSV

* **Charge Currency** → The currency of your account from which the payout amount will be deducted
* **Pay Currency** → The payout amount currency either it fiat or crypto
* **Pay Amount** →The payout amount
* **Pay Network** → The combination of blockchain/network to which the payout will be sent and a token, e.g. TRX:USDT means USDT will be sent over the Tron network (TRC20). Refer to the list of supported networks [here](/api-basics/supported-currencies.md)
* **Address** → The recipient's wallet address
* **Destination Tag** → Required only for XRP transactions
* **Reference** → A unique reference ID to link the payout to a recipient. This can be any identifier you choose, but it must be unique for each payout in the transaction
* **Beneficiary Type** → Select either **legal\_person** (for companies/organizations) or **natural\_person** (for persons)
* **Primary Identifier** →
  * If **legal\_person** → The complete legal entity name
  * If **natural\_person** → The first name
* **Secondary Identifier** →
  * If **legal\_person** → Leave empty
  * If **natural\_person** → The last name
* **Registered Address** →
  * If **legal\_person** → The official registered company address
  * If **natural\_person** → The residence address
* **City** → City name
* **Country** → Country name

## Example: How to Populate the Mass Payout CSV

### **Scenario 1**: Charging in Fiat and Paying in Crypto

<table data-header-hidden data-full-width="true"><thead><tr><th></th><th></th><th></th><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Charge Currency</strong></td><td><strong>Pay Currency</strong></td><td><strong>Pay Amount</strong></td><td><strong>Pay Network</strong></td><td><strong>Address</strong></td><td><strong>Destination Tag</strong></td><td><strong>Reference</strong></td></tr><tr><td>EUR</td><td>USDT</td><td>1000</td><td>TRX:USDT</td><td>TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe</td><td>(empty)</td><td>(empty)</td></tr></tbody></table>

* This payout is **charged in EUR** from the sender’s account
* The recipient receives **1000** **USDT on the TRON network (TRX:USDT)**
* The recipient's wallet address is **TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe**

### Scenario 2: Charging in Fiat and Paying in Fiat

<table data-header-hidden data-full-width="true"><thead><tr><th></th><th></th><th></th><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Charge Currency</strong></td><td><strong>Pay Currency</strong></td><td><strong>Pay Amount</strong></td><td><strong>Pay Network</strong></td><td><strong>Address</strong></td><td><strong>Destination Tag</strong></td><td><strong>Reference</strong></td></tr><tr><td>EUR</td><td>EUR</td><td>1000</td><td>TRX:USDT</td><td>TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe</td><td>(empty)</td><td>(empty)</td></tr></tbody></table>

* This payout is charged in EUR from the sender’s account.
* The recipient receives 1,000 EUR worth of USDT on the TRON network (TRX:USDT).
* The recipient’s wallet address is TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe.

### **Scenario 3**: Charging and Paying in the Same Cryptocurrency

<table data-header-hidden data-full-width="true"><thead><tr><th></th><th></th><th></th><th></th><th></th><th></th><th></th><th></th></tr></thead><tbody><tr><td><strong>Charge Currency</strong></td><td><strong>Pay Currency</strong></td><td><strong>Pay Amount</strong></td><td><strong>Pay Network</strong></td><td><strong>Absorb Fees</strong></td><td><strong>Address</strong></td><td><strong>Destination Tag</strong></td><td><strong>Reference</strong></td></tr><tr><td>USDT</td><td>USDT</td><td>1000</td><td>TRX:USDT</td><td>FALSE</td><td>TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe</td><td>(empty)</td><td>(empty)</td></tr></tbody></table>

* This payout is **charged directly in USDT**, meaning the amount specified (1000 USDT) is sent without conversion
* The recipient receives **1000 USDT on the TRON network (TRX:USDT)**
* The recipient’s wallet address is **TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe**

## List of Supported Currencies

{% content-ref url="/pages/SA7q0b6VrvXO3W09TQfS" %}
[Supported currencies](/api-basics/supported-currencies.md)
{% endcontent-ref %}


---

# 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://docs.txn.io/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.