# 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 uplodading 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="<https://1963856601-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgfUDRstNYYBTf2futZ28%2Fuploads%2Fs51z1KoFqNCMHTZC4kN7%2Ftx_mass_payout_template.csv?alt=media&token=a848a699-6bde-453d-b032-32d0ce372ccb>" %}

## 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&#x20;
* **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](https://docs.txn.io/api-basics/supported-currencies)&#x20;
* **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** →&#x20;
  * If **legal\_person** → The complete legal entity name
  * If **natural\_person** → The first name
* **Secondary Identifier** →&#x20;
  * If **legal\_person** → Leave empty
  * If **natural\_person** → The last name
* **Registered Address** →&#x20;
  * 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="api-basics/supported-currencies" %}
[supported-currencies](https://docs.txn.io/api-basics/supported-currencies)
{% endcontent-ref %}