Payouts

Every merchant gets one free scheduled payout per day — Tribridge covers the network gas. Need funds sooner? Request an additional payout any time; only the network gas is deducted from your balance. Tribridge never charges a withdrawal fee. All payouts are confirmed with a one-time email code, and executed from the Tribridge vault on-chain.

How it works

Balance settles

Collected payments are confirmed and settled into your available balance (net of prior payouts).

Check context

Call GET /payouts/context to see per-chain available and pending balances plus your linked payout wallets.

Request a code

Call POST /payouts/request-otp. Tribridge emails a 6-digit confirmation code to your account. A destination wallet is required before a code is issued — either a linked payout wallet or an explicit destination_address.

Execute the payout

Call POST /payouts with the code. The payout is executed on-chain from the vault to your destination.

Get payout context

GET /payouts/context — Everything the payout UI needs in one call: available balance per chain (net of prior payouts), pending balance, and your linked payout wallets. Add ?mode=live|test to scope it.

Example response

{
  "total_available": 9.5,
  "balances": [
    { "chain": "solana", "available": 5.5, "pending": 0 },
    { "chain": "sui",    "available": 4.0, "pending": 1 }
  ],
  "wallets": [
    { "chain": "solana", "address": "6nvzJiGH…" }
  ]
}

Request a confirmation code

POST /payouts/request-otp — Emails a payout confirmation code to your account. Call this before POST /payouts.

cURL

curl -X POST https://tribridge.onrender.com/payouts/request-otp \
  -H "Authorization: Bearer <JWT>"

Dashboard sessions use your login JWT (Authorization: Bearer) for payout endpoints — not the x-api-key. API keys authenticate merchant server integrations; payouts are a dashboard-level money movement, hence the extra email-code step.

Execute a payout

POST /payouts — Creates and executes a payout. Requires the confirmation code from the previous step.

Field	Type	Required	Description
`chain`	string	Yes	`solana` or `sui`.
`coin_symbol`	string	Yes	`USDC` / `USDT`.
`amount`	number	Yes	Amount to withdraw. Must not exceed the available balance.
`destination_address`	string	No	Defaults to your linked payout wallet for that chain.
`otp`	string	Yes	The emailed 6-digit confirmation code.

cURL

curl -X POST https://tribridge.onrender.com/payouts \
  -H "Authorization: Bearer <JWT>" \
  -H "Content-Type: application/json" \
  -d '{
    "chain": "solana",
    "coin_symbol": "USDC",
    "amount": 5.00,
    "otp": "123456"
  }'

List payouts

GET /payouts — Lists your payouts, newest first, with status, amount, destination, and transaction hash.

Payments

Developers

How it works

Get payout context

Request a confirmation code

Execute a payout

List payouts

​How it works

​Get payout context

​Request a confirmation code

​Execute a payout

​List payouts

How it works

Get payout context

Request a confirmation code

Execute a payout

List payouts