> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ca.cryptoprocessing.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mass payouts file format

To make a mass payout, you need to prepare a CSV file describing all the transactions you want to make. The file must contain no more than **2000 data rows**, and its size must not exceed **1 MB**.

The file must start with a header row that lists these columns in the specified order. Each data row must contain five values, separated by either commas or semicolons.

> [tab] Standard mass payouts
>
> * **Address** — the recipient's address.
> * **Tag** — the recipient's [Tag field](https://docs.ca.cryptoprocessing.com/deposits/tags.md). Leave empty for currencies that do not require a Tag field.
> * **Currency** — the ISO code of the currency to send.
> * **Amount** — the amount of funds to send.
> * **Note** — a note to save in the [transaction history](https://docs.ca.cryptoprocessing.com/portal.md#viewing-transactions-history). If [business wallet transactions callbacks](https://docs.ca.cryptoprocessing.com/merchant-administration/configure-callbacks.md#additional-callbacks) are enabled, it's also sent in the `note` field of the [withdrawal callback](https://docs.ca.cryptoprocessing.com/api-reference/callbacks/withdrawal-callbacks.md). Leave empty to skip adding a note for the transaction.
>
> ```csv sample.csv theme={null}
> Address,Tag,Currency,Amount,Note
> bc1qar0srrr7xfkvy5l643lydnw9re59gtzzwf5mdq,,BTC,0.0025,Salary for Alice
> 0x59E497D1AEf6B696B66F503D85d9b29A0e2930E8,,USDC,120.20,Salary for Bob
> r9NEXKYNyfxhzw7VzJp9et8t3onbam98G,2422386,XRP,400,Salary for Charlie
> ```

> [tab] Mass payouts with currency conversion
>
> * **From Currency** — the currency you want to convert from.
> * **Amount to Send** — the amount of funds to send. Fill in either this field or the Amount to Receive.
> * **Address** — the recipient's address.
> * **Tag** — the recipient's [Tag field](https://docs.ca.cryptoprocessing.com/deposits/tags.md). Leave empty for currencies that do not require a Tag field.
> * **To Currency** — the currency you want to convert to.
> * **Amount to Receive** — the amount the recipient will receive. Fill in either this field or the **Amount to Send**.
> * **Note** — a note to save in the [transaction history](https://docs.ca.cryptoprocessing.com/portal.md#viewing-transactions-history). If [business wallet transactions callbacks](https://docs.ca.cryptoprocessing.com/merchant-administration/configure-callbacks.md#additional-callbacks) are enabled, it's also sent in the `note` field of the [withdrawal callback](https://docs.ca.cryptoprocessing.com/api-reference/callbacks/withdrawal-callbacks.md). Leave empty to skip adding a note for the transaction.
>
> ```csv sample_with_conversion.csv theme={null}
> From Currency,Amount to Send,Address,Tag,To Currency,Amount to Receive,Note
> CAD,100,bc1q5ek0zq6dn4delgxnu5va0ttmlmgkgx3r04xare,,BTC,,Salary for Alice
> CAD,,0x7382FD00Ed0EF743044977D81673D7B87b87082C,,USDC,200,Salary for Bob
> ETH,1,rPpGnDVzyfqJhjn2bybATLQxsDx1QfdU6c,1278637,XRP,,Salary for Charlie
> ```
>
> > [!NOTE]
> >
> > Only fill in either the **Amount to Receive** or the **Amount to Send**. CryptoProcessing will calculate the other value automatically. If you include both fields, you will get an error message.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.