Txn.pro - API Documentation
Sandbox LoginChangelogStatus Page
  • Getting setup
    • Environments
    • Creating a Sandbox account
    • Back office user roles
    • Creating your API keys
    • Postman collection
  • API Basics
    • API specification
    • API status
    • Supported currencies
    • Date and time format
    • Authenticating the API
    • Webhooks
      • Verifying webhooks
      • Source IP addresses
      • Retrying schedule
    • Rate limits
  • Hosted pages
  • Accounts
    • Accounts concept
    • Listing accounts
    • Reading account
    • Listing account addresses
    • Creating account address
    • Listing account transactions
    • Reading account transaction
  • Exchange
    • Exchange concept
    • Supported currency pairs
    • Reading exchange rates
    • Exchange webhooks
    • Creating quote
    • Confirming quote
  • Invoices
    • Invoices concept
    • Invoice status flow
    • Invoices in cashier
    • Invoice limitations
    • Listing invoice currency pairs
    • Invoice webhooks
    • Creating invoice
    • Reading invoice
    • Listing invoices
    • Invoice refunds
  • Payouts
    • Payouts concept
    • Payout status flow
    • Payout limitations
    • Listing payout currency pairs
    • Validating addresses
    • Payout webhooks
    • Creating payout
    • Reading payout
    • Listing payouts
  • Mass Payouts
  • PAYMENT LINKS
    • Payment links concept
    • Creating payment link
    • Expiring payment link
    • Reading payment link
    • Listing payment links
  • CHANNELS
    • Channels concept
    • Channels deposit flow
    • Listing channel currency pairs
    • Channel webhooks
    • Creating channel
    • Reading channel
    • Updating channel
    • Listing channels
    • Listing channel deposits
    • Reading channel deposit
  • (BETA) Fiat Settlements
    • Important information
    • Bank withdrawal webhooks
    • Bank deposit webhooks
    • Listing bank accounts
    • Reading bank account
    • Previewing bank withdrawal
    • Creating bank withdrawal
    • Listing bank withdrawals
    • Reading bank withdrawal
    • Listing bank deposits
    • Reading bank deposit
Powered by GitBook
On this page
  • What is Mass Payouts?
  • How It Works
  • CSV Template
  • How to Populate the Mass Payout CSV
  • Example: How to Populate the Mass Payout CSV
  • Scenario 1: Charging in Fiat and Paying in Crypto
  • Scenario 2: Charging and Paying in the Same Cryptocurrency
  • List of Supported Currencies

Mass Payouts

PreviousListing payoutsNextPayment links concept

Last updated 20 days ago

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

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

  • 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

Example: How to Populate the Mass Payout CSV

Scenario 1: Charging in Fiat and Paying in Crypto

Charge Currency

Pay Currency

Pay Amount

Pay Network

Address

Destination Tag

Reference

EUR

USDT

1000

TRX:USDT

TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe

(empty)

(empty)

  • 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 and Paying in the Same Cryptocurrency

Charge Currency

Pay Currency

Pay Amount

Pay Network

Absorb Fees

Address

Destination Tag

Reference

USDT

USDT

1000

TRX:USDT

FALSE

TTbGTMwUwA3mncLP7xqCZei1ekaNSgeAJe

(empty)

(empty)

  • 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

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
Supported currencies
2KB
txn-mass-payout-template.csv