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.

Standard mass payouts
Mass payouts with currency conversion

Address — the recipient’s address.
Tag — the recipient’s Tag field. 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. Leave empty to skip adding a note for the transaction.

sample.csv

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

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. 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. Leave empty to skip adding a note for the transaction.

sample_with_conversion.csv

From Currency,Amount to Send,Address,Tag,To Currency,Amount to Receive,Note
EUR,100,bc1q5ek0zq6dn4delgxnu5va0ttmlmgkgx3r04xare,,BTC,,Salary for Alice
EUR,,0x7382FD00Ed0EF743044977D81673D7B87b87082C,,USDC,200,Salary for Bob
ETH,1,rPpGnDVzyfqJhjn2bybATLQxsDx1QfdU6c,1278637,XRP,,Salary for Charlie

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.

Last modified on October 23, 2026

Get started

Merchant account setup

Reporting

Deposits

Payment requests

Withdrawals

Mass payouts

Exchanges

Fiat

Available plugins

Compliance