USDT payouts

1. Request a quote#

POST /api/v1/merchant/crypto/payouts/quote

curl -X POST https://api.niripay.com/api/v1/merchant/crypto/payouts/quote \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"amount":"200.000000","address":"YOUR_VALID_TRON_RECIPIENT_ADDRESS"}'

Replace the placeholder address before using the API. A quote response contains quote_id, provider, amount, charge, total, destination, expires_at, currency, and network under data.

The recipient receives the quoted amount; the charge is additional. Review the quote before submitting it.

2. Submit the quote#

POST /api/v1/merchant/crypto/payouts

curl -X POST https://api.niripay.com/api/v1/merchant/crypto/payouts \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "quote_id": "QUOTE_ID_FROM_RESPONSE",
    "idempotency_key": "payout-order-123",
    "webhook_url": "https://merchant.example/webhooks/crypto"
  }'

3. Track the original payout#

Persist the returned transaction id and inspect its state. Query transaction status or process verified crypto callbacks. Request acceptance does not mean the blockchain transfer has completed.

Retry rules#

Reuse the same idempotency key, quote ID, and callback URL for retries of the same payout. A different request under the same key returns a conflict.

If the outcome is unknown, query the original payout; do not create a replacement. Expired or changed quotes need a fresh quote and review before a new, unsubmitted payout is authorized.

Common errors#