Stablecoin Payouts

Use the Payouts API to send funds to stablecoin wallets. Set paymentMethodId to "crypto" and provide a recipient object with type: "crypto_wallet".

Request Shape

Set paymentMethodId to "crypto" and provide recipient with the following structure:

Top-level required fields for every payout:

• Required: merchantId, merchantReference, destinationValue (with minorAmount and currency), paymentMethodId ("crypto"), paymentLocation, recipient
• Optional: sender, attributes

Example Request

1
{
2
  "merchantId": "your-merchant-id",
3
  "merchantReference": "PAYOUT-2024-004",
4
  "destinationValue": {
5
    "minorAmount": 2500000,
6
    "currency": "USDC"
7
  },
8
  "paymentMethodId": "crypto",
9
  "paymentLocation": "USA",
10
  "recipient": {
11
    "type": "crypto_wallet",
12
    "address": "0x1111222233334444555566667777888899990000",
13
    "network": "ERC20",
14
    "memo": "customer-123"
15
  },
16
  "attributes": {}
17
}

Note: minorAmount: 2500000 = 2.500000 USDC.

Required vs Optional Summary

• Required for recipient (crypto_wallet): type ("crypto_wallet"), address, network
• Optional for recipient: memo
• Required at request level: merchantId, merchantReference, destinationValue, paymentMethodId, paymentLocation, recipient
• Optional at request level: sender, attributes

Supported Stablecoins and Networks

Amount Format

Amounts are specified in minor units (integer). USDT/USDC use 6 decimal places:

• 1000000 minorAmount = 1.000000 USDT/USDC
• 2500000 minorAmount = 2.500000 USDT/USDC

Payment Location

paymentLocation is required for all payouts. For stablecoin payouts, use the recipient’s 3-letter ISO country code when known. If the recipient’s country is unknown, use your business country code.

Next Steps

• Single Payouts — One-off payouts
• Bulk Payouts — Batch payouts
• Supported Destinations — Currencies and rails by destination