​
Overview

Transfer stablecoins from your Juice balance to external crypto addresses across multiple supported chains. This endpoint handles stablecoin payouts with automated rate conversion and chain validation.

​
Supported Tokens and Chains

USDT Support

  • Ethereum (ETH)

  • Tron (TRX)

  • BNB Smart Chain (BSC)

USDC Support

  • Ethereum (ETH)

  • Polygon (MATIC)

  • Avalanche C-Chain (AVAXC)

Always verify the destination chain matches the selected token to avoid lost transactions. Not all tokens are supported on all chains.

​
Transaction Limits

​
Endpoint

POST /payouts

​
Request Parameters

​
amount
integer
required

Amount in minor units (e.g., 100000 = 1000.00 USD)

  • Minimum: 1000 (10 USD)

  • Maximum: 10000000 (100,000 USD)

​
beneficiary_id
string
required

ID of the pre-registered crypto address beneficiary

​
beneficiary_type
string
required

Must be “crypto_address”

​
description
string
required

Purpose or description of the transfer

  • Maximum length: 140 characters
​
destination_currency
string
required

Stablecoin token type

  • Supported values: “USDT”, “USDC”
​
source_currency
string
required

Must be “USD”

​
reference
string
required

Unique identifier for the transfer

  • Must be unique across all transfers

  • Alphanumeric characters only

​
pin
string
required

6-digit authorization PIN

​
Example Request

{
  "amount": 100000,
  "beneficiary_id": "5d906f6d-933b-4de9-927f-c7522823f5ec",
  "beneficiary_type": "crypto_address",
  "description": "Payment for services",
  "destination_currency": "USDT",
  "pin": "123456",
  "reference": "juice-payout-5d906f6d-933b-4de9-927f-c7522823f5ec",
  "source_currency": "USD"
}

​
Success Response

{
  "data": {
    "beneficiary": {
      "chain": "TRX",
      "address": "TRDFGhjkytywooiueonuoo",
      "id": "d8c0226b-048c-4c44-9606-a93333f56283",
      "type": "crypto_address"
    },
    "beneficiary_type": "crypto_address",
    "created_at": "2024-03-01T02:29:49Z",
    "destination_amount": 100000,
    "destination_currency": "USDT",
    "id": "93cf071e-d773-11ee-bf78-c6d49632367b",
    "source_amount": 100000,
    "source_currency": "USD",
    "status": "pending",
    "updated_at": "2024-03-01T02:29:53Z"
  }
}

​
Error Responses

​
Best Practices

  1. Chain Selection

    • Use TRX for lowest fees

    • Consider ETH during low gas periods

    • Use MATIC/AVAXC for faster confirmations

  2. Error Handling

    • Implement retry logic with exponential backoff

    • Monitor network congestion

    • Handle timeouts gracefully

  3. Validation

    • Verify beneficiary addresses before transfer

    • Check sufficient balance

    • Validate against transfer limits

  4. Monitoring

    • Track transfer status via webhooks

    • Monitor blockchain confirmations

    • Log all transfer attempts

Need Help?

For additional assistance: