Merchant API documentation

Base URL

https://stablecoin.triptz.net/api/v1/merchant

Authentication

Send your API key on every request:

X-Api-Key: sc_live_…

API keys are issued after merchant onboarding. Sign in to the merchant portal or contact us to get started.

Supported networks (auto-confirm)

• tron — USDT TRC20
• bnb — USDT BEP20
• bitcoin — BTC

Create payment

POST /v1/merchant/payments

USDT on TRON

{
  "amount_usdt": 25.5,
  "external_reference": "order-12345",
  "network": "tron"
}

USDT on BNB Chain

{
  "amount_usdt": 25.5,
  "external_reference": "order-12346",
  "network": "bnb"
}

Bitcoin

{
  "amount_btc": 0.0015,
  "external_reference": "order-12347",
  "network": "bitcoin",
  "asset": "BTC"
}

Response includes settlement_address and exact amount. Auto-confirmation runs within ~1 minute on all three networks.

Get payment status

GET /v1/merchant/payments/{reference}

List payments

GET /v1/merchant/payments?status=pending&limit=50

Get balance

GET /v1/merchant/balance

Returns available USDT, estimated TZS cash-out value, pending PayIn TZS collections, and auto-settlement status.

List settlements

GET /v1/merchant/settlements?limit=50

Withdrawals, M-Pesa cash-outs, wallet payments, and auto-settlement run history.

Withdraw to M-Pesa

POST /v1/merchant/withdraw/mpesa

{
  "amount_usdt": 50.0,
  "mobile_operator": "mpesa"
}

Withdraw USDT on-chain

POST /v1/merchant/withdraw/usdt

{
  "amount_usdt": 100.0,
  "chain": "tron",
  "to_address": "T..."
}

Omit to_address to use your configured settlement wallet.

Convert TZS to USDT

POST /v1/merchant/convert

Converts pending PayIn TZS collections to your internal USDT balance. Requires collected TZS in pending_collection_tzs.

Webhooks