Skip to main content

Enable mass payouts

Set up your Volet.com account to send payouts to freelancers, creators, affiliates, partners, or other recipients through the API.

Custodial mass payouts are sent from your Volet.com account to Volet.com users or external crypto wallets.

Non-custodial mass payout integrations do not require a Volet.com account. They are executed directly from your own wallet through smart contracts. Please contact our team for integration details.

Before you start​

To use custodial mass payouts, you need a verified Volet.com account.

See Business verification or Personal verification. Compare account types: Business vs Personal.

Step 1: Create an API​

Log in to your Volet.com dashboard, go to Payment Tools, and click Create in the API section.

Step 2: Configure API settings​

Configure the basic API settings.

  1. API name. Internal name of the API. This name is used only inside your Volet.com account.

  2. IP whitelist. List of IP addresses allowed to access the API.

    You can:

    • Enter one or more IP addresses manually.
    • Click Add current IP to automatically add your current IP address.
    • Enable Allow all IPs to disable IP restrictions. This is not recommended for production environments.

  3. API password. Secret key used to authenticate API requests. Keep it private and do not expose it in client-side code.

  4. Website, mobile app, bot, or AI agent URL. Public URL associated with this API integration.

Examples:

  • https://example.com
  • https://app.example.com
  • https://t.me/example_bot

Step 3: Configure API permissions​

Choose which permissions will be available for this API.

For payout integrations, enable the payout permissions your application needs:

  • Make transactions

    • Payouts to Volet.com users — allows your application to send funds to recipients' Volet.com accounts.
    • Payouts to external crypto wallets — allows your application to send cryptocurrency payouts to external wallet addresses.
    • Payouts to crypto from fiat wallets — allows your application to send crypto payouts from fiat balances using automatic conversion.
    • Exchange funds between Volet.com wallets — allows your application to exchange funds between your own Volet.com wallets before sending payouts, if required by your payout flow.

You may also need the following permissions:

  • Get balance per wallet — allows your application to retrieve the balance of a specific wallet before creating payouts.
  • Find transaction — allows your application to retrieve payout status and transaction details after a payout has been created.
  • Transaction history — allows your application to retrieve transaction history for reconciliation and reporting.

Enable only the permissions required by your integration.

See API reference for more details.

Step 4: Approval​

No separate approval is required to use the Mass Payout API after the API has been created and configured.

Step 5: Integrate​

After the API is configured, you can start sending payouts through the API.

See:

  • API integration — how-to guide for API mass payout integration.
  • API reference — complete methods, parameters, and response documentation.