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,
    "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": 0,
    "net_amount": 100,
    "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	None
Gas	Paid by you

Payouts have no Traxvo fees. You only pay the network gas fee for broadcasting the transaction.

Webhooks

Payout webhooks are sent to callback_url:

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

Webhook Events

Event	Description
`payout.pending`	Payout created, awaiting signature
`payout.signed`	Transaction signed, ready to broadcast
`payout.confirming`	Transaction broadcast, awaiting confirmations
`payout.completed`	Payout confirmed on chain
`payout.failed`	Payout failed
`payout.cancelled`	Payout cancelled

Bulk Payouts

Currently, each payout is processed as an individual transaction. Each payout requires:

Create payout request
Sign on hardware wallet
Broadcast transaction

Why no batch payouts?

Standard TRC20/BEP20 transfers only support one recipient per transaction. Batching multiple payouts into a single transaction would require:

Custom smart contracts deployed on each chain
More complex transaction signing
Higher gas costs for contract execution

For high-volume payouts, we recommend:

Queue payouts: Collect pending payouts and process them sequentially
Use dashboard: The Traxvo dashboard allows signing multiple payouts efficiently
Automate with API: Build automation to create and sign payouts programmatically

Security

Non-Custodial Design

Traxvo never has access to your private keys:

Private keys remain on your hardware wallet
We only provide unsigned transactions
You sign and broadcast through your own device

Hardware Wallet Benefits

Feature	Benefit
Offline signing	Private keys never touch the internet
Physical confirmation	Each transaction requires button press
Tamper-resistant	Hardware designed to protect keys
Multi-currency	Same device for TRON and BSC

Best Practices

Use dedicated payout wallet - Keep payout funds separate from main holdings
Monitor balances - Ensure payout wallet has sufficient funds
Verify addresses - Double-check recipient addresses on device screen
Set up webhooks - Get real-time notifications for all payout events

Payouts

On this page