Features

• Bulk transactions: Send payments to up to 500 recipients in one go.
• Multiple roles support: Different roles for users, where an accountant can create the mass payout, and an admin or owner can review and launch the payouts, ensuring better control and security.
• Multiple cryptocurrencies: Support for a variety of cryptocurrencies including Bitcoin (BTC), Ethereum (ETH), Tether (USDT) and Litecoin (LTC). One payout may consists of different cryptocurrencies.
• Automated processing: Automated handling of large payout batches to reduce manual effort and errors.
• Detailed reporting: Comprehensive reports on payout status, transaction history, and more.
• API Integration: Seamless integration with your existing systems through robust API support.

Prerequisites

• An active KUNA Pay account.
• Sufficient cryptocurrency balance in your KUNA Pay wallet to cover the total payout amount.
• A CSV file containing recipient details (wallet addresses and amounts). You can download the template during Mass payout creation.

Step-by-step guide

1. Go to the Mass payout section from the dashboard.

2. Create a mass payout: Upload the CSV file containing the amounts and wallet addresses. KUNA Pay supports various wallet types and allows up to 500 receivers in one CSV file. After uploading, verify the recipient details and the total payout amount.

3. Save or launch the payout: You can either save the payout as a draft or proceed to launch it immediately. Ensure an authorized individual reviews and confirms the payout batch before launching.

   

4. Track the payout: Monitor the payout status in real-time through the merchant cabinet or API.

5. Download the Mass payout report: After launching, download a detailed report of all transactions.

Payout via API

To initiate a payout, you can use /v1/payout endpoint.

To get a list of available payment methods for payout, you can use the /v1/payout/pre-request endpoint.

To get a list of Payouts, you can use GET /v1/payout endpoint.

To get transactions by Payout, you can use /v1/transaction endpoint and pass the “payoutId” field to the filter.

Callbacks

To receive callbacks about the status of a payout(and transactions), you need to include the following parameters when creating a payout "/v1/payout":

{
  ...
  externalId?: string; // External payout identifier
  callbackSettings: {
    url: string;
    shouldSendTransactionalCallback?: boolean; // Enables transactional callbacks
  }
}

When the parameter "shouldSendTransactionalCallback" is set to true, callbacks will be sent about the status of each Payout transaction.
You can read more about callbacks in this article Callbacks

For each contractor in Payout, you can pass an "externalId" to link transactional callbacks with a specific contractor:

{
  ...
  contractors: [
    {
      ...
      externalId?: string;
    }
  ]
}