Payouts

Send USDT/USDC to your users using your connected hardware wallet. Non-custodial - you control the private key.

How It Works

1. Connect hardware wallet (Ledger/Trezor)
2. Create payout request via API
3. Sign transaction on hardware device
4. Submit signed transaction to broadcast

Connect Payout Wallet

Connect your hardware wallet address for each chain.

POST /v1/payout/wallet

Request

{
  "chain": "TRON",
  "address": "TYourHardwareWalletAddress...",
  "label": "My Ledger"
}

Response

{
  "status": "success",
  "wallet": {
    "id": "wallet_123",
    "chain": "TRON",
    "address": "TYourHardwareWalletAddress...",
    "label": "My Ledger",
    "is_active": true,
    "created_at": "2024-01-15T10:00:00.000Z"
  }
}

Create Payout

Create a payout request and receive an unsigned transaction.

POST /v1/payout/create

Request

{
  "chain": "TRON",
  "token": "USDT",
  "to_address": "TUserWalletAddress...",
  "amount": 100,
  "metadata": {
    "user_id": "user_123",
    "withdrawal_id": "wd_456"
  },
  "callback_url": "https://your-site.com/payout-webhook"
}

Response

{
  "status": "success",
  "payout": {
    "id": "payout_abc123",
    "chain": "TRON",
    "token": "USDT",
    "from_address": "TYourHardwareWallet...",
    "to_address": "TUserWalletAddress...",
    "amount": 100,
    "fee": 1,
    "net_amount": 99,
    "unsigned_tx": "{...}",
    "expires_at": "2024-01-15T10:10:00.000Z",
    "created_at": "2024-01-15T10:00:00.000Z"
  }
}

Sign Transaction

Sign the unsigned_tx using your hardware wallet:

Ledger (JavaScript)

import TransportWebUSB from "@ledgerhq/hw-transport-webusb";
import Trx from "@ledgerhq/hw-app-trx";
 
async function signWithLedger(unsignedTx) {
  const transport = await TransportWebUSB.create();
  const trx = new Trx(transport);
 
  const tx = JSON.parse(unsignedTx);
  const signedTx = await trx.signTransaction(
    "44'/195'/0'/0/0", // derivation path
    tx.raw_data_hex
  );
 
  return signedTx;
}

Trezor (JavaScript)

import TrezorConnect from "@trezor/connect-web";
 
async function signWithTrezor(unsignedTx) {
  const tx = JSON.parse(unsignedTx);
 
  const result = await TrezorConnect.tronSignTransaction({
    path: "m/44'/195'/0'/0/0",
    transaction: tx
  });
 
  return result.payload.serializedTx;
}

Broadcast Transaction

Submit the signed transaction for broadcasting.

POST /v1/payout/:id/broadcast

Request

{
  "signed_tx": "{...signed transaction...}"
}

Response

{
  "status": "success",
  "payout": {
    "id": "payout_abc123",
    "tx_hash": "abc123def456...",
    "status": "confirming"
  }
}

Check Payout Status

GET /v1/payout/:id

Response

{
  "status": "success",
  "payout": {
    "id": "payout_abc123",
    "chain": "TRON",
    "token": "USDT",
    "from_address": "TYourHardwareWallet...",
    "to_address": "TUserWalletAddress...",
    "amount": 100,
    "fee": 1,
    "net_amount": 99,
    "status": "completed",
    "tx_hash": "abc123def456...",
    "confirmations": 19,
    "created_at": "2024-01-15T10:00:00.000Z"
  }
}

List Payouts

GET /v1/payout

Query Parameters

Parameter	Type	Default	Description
`limit`	number	50	Results per page (max 100)
`offset`	number	0	Pagination offset
`status`	string	-	Filter by status

Payout Status Values

Status	Description
`pending`	Waiting for signature
`signed`	Signed, ready to broadcast
`broadcasting`	Being broadcast
`confirming`	Waiting for confirmations
`completed`	Confirmed on chain
`expired`	Unsigned tx expired (10 min)
`failed`	Failed to broadcast/confirm
`cancelled`	Cancelled by merchant

Cancel Payout

Cancel a pending (unsigned) payout.

POST /v1/payout/:id/cancel

Fee Structure


Fee	0.5% per payout
Minimum Fee	$1
Minimum Payout	$10

Webhooks

Payout webhooks are sent to callback_url:

{
  "event": "payout.completed",
  "payout_id": "payout_abc123",
  "tx_hash": "abc123def456...",
  "amount": 100,
  "net_amount": 99,
  "to_address": "TUserWalletAddress...",
  "metadata": {
    "user_id": "user_123"
  },
  "timestamp": "2024-01-15T10:05:00.000Z"
}

Payouts

On this page