StardDevelopersداشبورد

برداشت TON

POST/api/v1/wallet/ton/withdrawals
scope: wallet:writeاحراز هویت: Bearerlive و test

برداشت TON فقط به کیف پولی که مالک حساب با TON Connect در مینی‌اپ وصل کرده (آدرس دلخواه پذیرفته نمی‌شود تا کلید لو‌رفته نتواند پول را جای دیگری بفرستد). برداشت‌های غیرعادی به صف بررسی می‌روند.

درخواست

ناممحلنوعتوضیح
AuthorizationheaderstringالزامیBearer sk_live_… یا Bearer sk_test_…

بدنه (JSON)

فیلدنوعتوضیح
sourcestringالزامیton یا toman
amountstringالزامیمبلغ

نمونه

curl -X POST "https://stard-market.ir/api/v1/wallet/ton/withdrawals" \
  -H "Authorization: Bearer $STARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source": "ton", "amount": "2.5"}'

خطاها

HTTPcodeکی
400ton_wallet_not_linkedکیف پول TON وصل نیست
400live_onlyفقط با کلید live
403insufficient_scopeکلید scope wallet:write را ندارد
401invalid_api_key / missing_api_key / api_key_revoked / api_key_expiredکلید نیامده، نامعتبر، باطل یا منقضی است
429rate_limit_exceededسقف درخواست در دقیقه پر شده؛ بعد از Retry-After ثانیه دوباره بفرست

محدودیت نرخ

پیش‌فرض ۶۰ درخواست در دقیقه برای هر کلید (قابل تنظیم در داشبورد). وضعیت در هدرهای X-RateLimit-* برمی‌گردد — جزئیات.