{"info":{"_postman_id":"4abbc322-71b5-42fa-b990-d30e9a797ca6","name":"Tronado Public API","description":"

‫این کالکشن تمام endpoint های مورد نیاز برای توسعه‌ی اپلیکیشن‌ها و استفاده از API ترونادو را پوشش می‌دهد. برای هر endpoint مثال‌ها و DTO های Response به‌صورت کامل توضیح داده شده است.

\n

نکته مهم

\n

‫در داکیومنت GetOrderToken (فولدر Order) نحوه‌ی ایجاد تراکنش و استفاده از UI پرداخت درون‌برنامه‌ای ترونادو توضیح داده شده است. در این نوع پرداخت، مشتریان روی دکمه‌ی ربات کسب‌وکار شما کلیک می‌کنند و صفحه‌ی وب پرداخت ترونادو باز می‌شود؛ بدون ورود به ربات ترونادو پرداخت انجام می‌شود.

\n

‫قرارداد callback (IPN) به‌صورت کامل در فولدر «IPN Callback (Webhook)» توضیح داده شده — این مهم‌ترین بخش برای تطبیق و شارژ کاربر است.

\n

شروع سریع

\n

‫برای دریافت api key با پشتیبانی ترونادو ارتباط برقرار کنید و کسب‌وکار خود را احراز کنید.

\n

‫در هر Request این Header ها را اضافه کنید:

\n

x-api-key: <{api key}>

\n

Content-Type: application/json

\n

آدرس پایه (Base Url)

\n

https://bot.tronado.cloud = https://bot.tronado.cloud

\n

نسخه‌بندی (Versioning)

\n

‫ترونادو در API از نسخه‌های مختلف استفاده می‌کند. نسخه در مسیر URL بعد از آدرس اصلی قرار می‌گیرد: /api/v{version}/.... نسخه‌ی پیشنهادی فعلی v5 است.

\n

‫در v5 نسبت به نسخه‌های قبل:

\n\n

‫تنها اندپوینت GetOrderToken نسخه‌بندی می‌شود. مثال: https://bot.tronado.cloud/api/v5/GetOrderToken

\n

محدودیت‌های ایجاد تراکنش برای هر کاربر

\n\n

‫سقف ۵۰۰ هزار تومان روزانه قابل تغییر است؛ تعداد تراکنش‌های کنسل‌شده قابل تغییر نیست.

\n

قیمت‌گذاری (Pricing)

\n

‫کارمزد پیش‌فرض ۲۰٪ است اما برای هر کسب‌وکار قابل تنظیم است (با پشتیبانی هماهنگ کنید). حداقل کارمزد، بیشترِ (۹٬۰۰۰ تومان یا معادل ۰٫۱ دلار) است؛ یعنی اگر ۲۰٪ کارمزد شما کمتر از این مقدار شود، همین حداقل اعمال می‌شود.

\n

‫تعیین پرداخت‌کننده‌ی کارمزد با پارامتر wageFromBusinessPercentage انجام می‌شود (در GetOrderToken). این پارامتر تعیین می‌کند چه درصدی از کارمزد را کسب‌وکار جذب کند:

\n\n

‫⚠️ برای شارژ صحیح کاربر، به‌جای TronAmount (که مبلغ خالص دریافتی شماست) از UserPaidTomanAmount در callback نسخه‌ی v5 استفاده کنید.

\n

‫دقت کنید: برای ولت‌های NowPayments یا ولت‌های غیرفعال، حدود ۱٫۱ ترون (هزینه‌ی فعال‌سازی ولت در شبکه‌ی ترون) به مبلغ نهایی اضافه می‌شود. هزینه‌ی انتقال (تا ~۰٫۳ ترون) نیز برای ولت‌های فعال به مبلغ نهایی اضافه می‌شود. اگر مبلغی بیش از این اضافه شد با @trndSupport تماس بگیرید.

\n

تست در محیط Development

\n

‫با اکانتی که کسب‌وکار برایتان ثبت شده، این command ها را به ربات ترونادو بفرستید. برای تست روی localhost با ngrok یک external url بسازید و در CallbackUrl قرار دهید.

\n

‫ارسال یک IPN تستی ثابت به یک URL:

\n

/dummyrequest

\n

‫ارسال یک IPN تستی با داده‌ی دلخواه:

\n
/dummysuccessfulrequest {\n  \"PaymentID\": \"12345\",\n  \"UserTelegramId\": 123456,\n  \"Wallet\": \"Wallet\",\n  \"TronAmount\": 12.123456,\n  \"ActualTronAmount\": 12.123456,\n  \"CallbackUrl\": \"https://603f-xxxx.ngrok-free.app/Test/Test\"\n}\n\n

پشتیبانی

\n

‫برای پشتیبانی و هر سوال: https://t.me/TronadoSupp

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"نکته مهم","slug":"nkth-mhm"}],"owner":"48018954","collectionId":"4abbc322-71b5-42fa-b990-d30e9a797ca6","publishedId":"2sBXwwm7St","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-06-22T15:01:22.000Z"},"item":[{"name":"Order","item":[{"name":"GetOrderToken","id":"71165c8f-0691-4726-808d-b2564bb8ff8e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"PaymentID\": \"YOUR_PAYMENT_ID\",\n \"WalletAddress\": \"TXYZ12345abcdef...\",\n \"TronAmount\": 12.123456,\n \"CallbackUrl\": \"https://your-domain.com/payment/callback\"\n}","options":{"raw":{"language":"json"}}},"url":"https://bot.tronado.cloud/api/v5/GetOrderToken?wageFromBusinessPercentage=0","description":"

‫این endpoint برای ایجاد تراکنش جدید و گرفتن توکن آن به کار می‌رود. برای پرداخت مشتری در صفحه‌ی وب ترونادو نیز از همین اندپوینت استفاده کنید.

\n

‫⚠️ قبل از این درخواست، حتماً قیمت ترون را از فولدر Price/Tron بگیرید تا مقدار ترون درخواستی را درست محاسبه کنید.

\n

نسخه‌بندی

\n

‫نسخه در مسیر URL است: /api/v5/GetOrderToken. نسخه‌ی پیشنهادی v5 است (callback امضاشده + فیلدهای مبلغ تومانی + ارسال به‌ازای هر تغییر وضعیت).

\n

📥 Header های لازم

\n\n

📥 بدنه‌ی درخواست (JSON Body)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
PaymentIDstringشناسه‌ی پرداخت در سیستم شما (یکتا)
WalletAddressstringآدرس کیف پول مقصد
TronAmountdecimalمقدار ترون فاکتور
CallbackUrlstringآدرسی که نتیجه‌ی پرداخت به آن POST می‌شود (باید https باشد)
\n

📥 پارامترهای کوئری/مسیر

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
ParamمحلDefaultDescription
apiVersionمسیر URL (/api/v5/)1نسخه‌ی API — پیشنهادی v5
wageFromBusinessPercentagequery string0درصد کارمزدی که کسب‌وکار جذب می‌کند (۰ تا ۱۰۰). توضیح کامل در توضیحات کالکشن.
\n

📤 پاسخ (Response 200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
Tokenstringتوکن تراکنش
FullPaymentUrlstringلینک کامل پرداخت
ErrorMessagestringپیام خطا (در صورت وجود)
EstimatedTomanAmountstringمبلغ تخمینی به تومان (اختیاری، از v3 به بعد)
EstimatedTomanAmountExpireDateUtcstringتاریخ انقضای مبلغ تخمینی (UTC)
\n

پرداخت در صفحه‌ی وب ترونادو

\n

‫توکن را به انتهای این لینک اضافه کنید و روی دکمه‌ی ربات خود قرار دهید:\nhttps://t.me/tronado_robot/customerpayment?startapp={YOUR_TOKEN}\n‫مشتری با کلیک روی دکمه، وارد صفحه‌ی پرداخت می‌شود.

\n

نتیجه‌ی پرداخت

\n

‫نتیجه به‌صورت callback به CallbackUrl شما POST می‌شود — قرارداد کامل در فولدر «IPN Callback (Webhook)».

\n","urlObject":{"path":["api","v5","GetOrderToken"],"host":["https://bot.tronado.cloud"],"query":[{"description":{"content":"

‫۰ تا ۱۰۰ — درصد کارمزدی که کسب‌وکار جذب می‌کند. پیش‌فرض ۰.

\n","type":"text/plain"},"key":"wageFromBusinessPercentage","value":"0"}],"variable":[]}},"response":[{"id":"c30c3929-9af2-4b1d-8649-6c3cccf3ec4d","name":"200 - Success","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"PaymentID\": \"YOUR_PAYMENT_ID\",\n \"WalletAddress\": \"TXYZ12345abcdef...\",\n \"TronAmount\": 12.123456,\n \"CallbackUrl\": \"https://your-domain.com/payment/callback\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://bot.tronado.cloud/api/v5/GetOrderToken?wageFromBusinessPercentage=0","host":["https://bot.tronado.cloud"],"path":["api","v5","GetOrderToken"],"query":[{"key":"wageFromBusinessPercentage","value":"0"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"IsSuccessful\": true,\n \"Code\": 200,\n \"Message\": \"\",\n \"Data\": {\n \"Token\": \"1234abcd\",\n \"FullPaymentUrl\": \"https://t.me/Tronado_Robot?start=s_1234abcd\",\n \"ErrorMessage\": null,\n \"EstimatedTomanAmount\": \"150000\",\n \"EstimatedTomanAmountExpireDateUtc\": \"2025-09-09T12:34:56Z\"\n }\n}"},{"id":"021b6c1a-bcee-4256-89b7-402ccc17280b","name":"401 - Unauthorized","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"PaymentID\": \"YOUR_PAYMENT_ID\",\n \"WalletAddress\": \"TXYZ12345abcdef...\",\n \"TronAmount\": 12.123456,\n \"CallbackUrl\": \"https://your-domain.com/payment/callback\"\n}","options":{"raw":{"language":"json"}}},"url":{"raw":"https://bot.tronado.cloud/api/v5/GetOrderToken?wageFromBusinessPercentage=0","host":["https://bot.tronado.cloud"],"path":["api","v5","GetOrderToken"],"query":[{"key":"wageFromBusinessPercentage","value":"0"}]}},"status":"Unauthorized","code":401,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"IsSuccessful\": false,\n \"Code\": -1,\n \"Message\": \"Api key is wrong or not specified. Please contact https://t.me/TronadoSupp for requesting your API key. Then provide it in the Header of your request. Header Key Name is => x-api-key\",\n \"Data\": null\n}"}],"_postman_id":"71165c8f-0691-4726-808d-b2564bb8ff8e"},{"name":"GetStatus","id":"d2648979-a0c1-4ed1-8bc7-39e23608602e","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"Id\": \"YOUR_TRONADO_ORDER_ID\"\n}","options":{"raw":{"language":"json"}}},"url":"https://bot.tronado.cloud/Order/GetStatus","description":"

‫وضعیت و اطلاعات تراکنش را برمی‌گرداند.

\n

📥 Header های لازم

\n
    \n

  • x-api-key

    \n
    • \n

  • Content-Type: application/json

    \n
    • \n
\n

📥 بدنه‌ی درخواست

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
Idstringشناسه‌ی تراکنش — OrderId ترونادو یا TrndOrderID_{orderId} یا TXID
\n

📤 پاسخ (Response 200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
UniqueCodestringکد یکتا
PaymentIDstringشناسه‌ی پرداخت شما
UserTelegramIdlongشناسه‌ی کاربر تلگرام
Walletstringکیف پول مقصد
Hashstringهش تراکنش (TXID)
TronAmountdecimalمقدار ترون خالص تحویلی
ActualTronAmountdecimal?مقدار ترون اولیه پیش از تعدیل
OrderStatusIDint?شناسه‌ی عددی وضعیت سفارش. مقادیر:
۲۰ = WaitingForPayment (در انتظار عکس)
۲۵ = PhotoSentToAdmin (عکس ارسال شده به ادمین)
۲۷ = ReadyToTransfer (آماده برای انتقال ترون)
۳۰ = PaymentAccepted (تایید شده — پرداخت قطعی، IsPaid=true)
۴۰ = PaymentRejected (رد شده)
۲۰۰ = Cancelled (لغو شده)
OrderStatusTitlestringعنوان فارسی همان وضعیت (متناظر با OrderStatusID). همیشه فارسی ارسال می‌شود. صرفاً جهت نمایش است؛ منطق سمت پذیرنده باید روی OrderStatusID پیاده شود نه روی این متن.
نمونه‌ها: «در انتظار عکس»، «عکس ارسال شده به ادمین»، «آماده برای انتقال ترون»، «تایید شده»، «رد شده»، «لغو شده».
IsPaidboolپرداخت موفق؟
PaymentDatestringتاریخ پرداخت
\n

❌ خطا

\n

‫اگر سفارشی یافت نشود:

\n
{ \"Error\": \"No order found with this txid\" }\n\n
\n","urlObject":{"path":["Order","GetStatus"],"host":["https://bot.tronado.cloud"],"query":[],"variable":[]}},"response":[{"id":"e3c975b3-36ea-4b00-b6e6-771ae780d8d3","name":"200 - Found","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"Id\": \"YOUR_TRONADO_ORDER_ID\"\n}","options":{"raw":{"language":"json"}}},"url":"https://bot.tronado.cloud/Order/GetStatus"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"UniqueCode\": \"UniqueCode\",\n \"PaymentID\": \"YourApplicationPaymentID\",\n \"UserTelegramId\": 123456789,\n \"Wallet\": \"TXYZ12345abcdef...\",\n \"Hash\": \"0xabc123456def...\",\n \"TronAmount\": 100.25,\n \"ActualTronAmount\": 100.00,\n \"OrderStatusID\": 30,\n \"OrderStatusTitle\": \"PaymentAccepted\",\n \"IsPaid\": true,\n \"PaymentDate\": \"2025-09-09T15:30:00Z\"\n}"},{"id":"5a1bcddb-7258-45d7-a962-02f2ccfb6918","name":"200 - Not Found","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"Id\": \"UNKNOWN_ID\"\n}","options":{"raw":{"language":"json"}}},"url":"https://bot.tronado.cloud/Order/GetStatus"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"Error\": \"No order found with this txid\"\n}"}],"_postman_id":"d2648979-a0c1-4ed1-8bc7-39e23608602e"},{"name":"GetStatusByPaymentID","id":"63e418ca-e8f9-49e9-aa5f-b877726e526b","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"Id\": \"YOUR_APPLICATION_PAYMENT_ID\"\n}","options":{"raw":{"language":"json"}}},"url":"https://bot.tronado.cloud/Order/GetStatusByPaymentID","description":"

‫مانند GetStatus، اما با Id = شناسه‌ی پرداخت در اپلیکیشن شما (PaymentID).

\n

📥 بدنه‌ی درخواست

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
Idstringشناسه‌ی پرداخت در اپلیکیشن شما (همان PaymentID که در GetOrderToken فرستادید)
\n

‫ساختار پاسخ دقیقاً مانند GetStatus است.

\n","urlObject":{"path":["Order","GetStatusByPaymentID"],"host":["https://bot.tronado.cloud"],"query":[],"variable":[]}},"response":[{"id":"dfadf000-208a-41c1-83f7-2c00354d742e","name":"200 - Found","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"Id\": \"YOUR_APPLICATION_PAYMENT_ID\"\n}","options":{"raw":{"language":"json"}}},"url":"https://bot.tronado.cloud/Order/GetStatusByPaymentID"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"UniqueCode\": \"UniqueCode\",\n \"PaymentID\": \"YourApplicationPaymentID\",\n \"UserTelegramId\": 123456789,\n \"Wallet\": \"TXYZ12345abcdef...\",\n \"Hash\": \"0xabc123456def...\",\n \"TronAmount\": 100.25,\n \"ActualTronAmount\": 100.00,\n \"OrderStatusID\": 30,\n \"OrderStatusTitle\": \"PaymentAccepted\",\n \"IsPaid\": true,\n \"PaymentDate\": \"2025-09-09T15:30:00Z\"\n}"}],"_postman_id":"63e418ca-e8f9-49e9-aa5f-b877726e526b"}],"id":"c7b8e522-917e-428e-ae73-06eaca0fa579","description":"

‫فولدر ایجاد و رصد تراکنش.

\n
    \n
  • GetOrderToken: ایجاد تراکنش و دریافت توکن (قبل از آن قیمت ترون را از فولدر Price بگیرید).
    • \n
  • GetStatus: رصد وضعیت با شناسه‌ی ترونادو/TXID.
    • \n
  • GetStatusByPaymentID: رصد وضعیت با PaymentID اپلیکیشن خودتان.
    • \n
\n","_postman_id":"c7b8e522-917e-428e-ae73-06eaca0fa579"},{"name":"IPN Callback (Webhook)","item":[{"name":"Tronado -> Your CallbackUrl (example)","id":"54a25158-97e5-4726-9a96-f694af82dfe7","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"X-Tronado-Sig","value":"","description":"

‫امضای HMAC-SHA512 بدنه‌ی خام با کلید اختصاصی کسب‌وکار شما (hex)

\n"}],"body":{"mode":"raw","raw":"{\n \"UniqueCode\": \"3f2a9c...\",\n \"PaymentId\": \"YOUR_PAYMENT_ID\",\n \"UserTelegramId\": 123456789,\n \"Wallet\": \"TXYZ12345abcdef...\",\n \"Hash\": \"0xabc123...\",\n \"TronAmount\": 1.493737,\n \"ActualTronAmount\": 1.493737,\n \"UserPaidTomanAmount\": 102030,\n \"TomanAmountWithoutWage\": 84085,\n \"OrderStatusID\": 30,\n \"OrderStatusTitle\": \"PaymentAccepted\",\n \"IsPaid\": true,\n \"PaymentDate\": \"2026-06-20T15:27:00.1830000\"\n}","options":{"raw":{"language":"json"}}},"url":"https://your-domain.com/payment/callback","description":"

‫⚠️ این درخواست را شما ارسال نمی‌کنید — این همان چیزی است که ترونادو به CallbackUrl شما POST می‌کند. اینجا فقط برای مستندسازی قرار گرفته.

\n

رفتار (نسخه v5)

\n
    \n

  • ‫برای هر تغییر وضعیت سفارش یک callback جداگانه به CallbackUrl شما ارسال می‌شود.

    \n
    • \n

  • ‫برای تشخیص پرداخت موفق: IsPaid == true یا OrderStatusID == 30 (PaymentAccepted) را بررسی کنید.

    \n
    • \n

  • ‫درخواست‌های تکراری را با کلید (PaymentId, OrderStatusID) حذف تکرار کنید (idempotent).

    \n
    • \n

  • ‫برای تأیید دریافت، کد 2xx برگردانید. در غیر این صورت ترونادو دوباره تلاش می‌کند.

    \n
    • \n
\n

امنیت — تأیید امضا (الزامی)

\n

‫هر callback یک هدر X-Tronado-Sig دارد:

\n
X-Tronado-Sig = HMAC_SHA512(rawJsonBody, YOUR_IPN_SIGNING_KEY)   // به‌صورت hex\n\n

‫کلید اختصاصی کسب‌وکار شما (IpnSigningKey) را از پشتیبانی دریافت می‌کنید. روی بدنه‌ی خام (raw bytes) قبل از هرگونه parse امضا را محاسبه و با مقایسه‌ی ثابت‌زمان با هدر تطبیق دهید؛ اگر برابر نبود درخواست را رد کنید.

\n

‫نمونه (Node.js):

\n
const crypto = require('crypto');\nconst sig = crypto.createHmac('sha512', YOUR_IPN_SIGNING_KEY)\n                  .update(rawBody)            // بدنه‌ی خام، نه JSON.stringify\n                  .digest('hex');\nif (!crypto.timingSafeEqual(Buffer.from(sig), Buffer.from(req.header('X-Tronado-Sig')))) {\n  return res.status(401).end();\n}\n\n
\n

‫نمونه (C#):

\n
using var h = new HMACSHA512(Encoding.UTF8.GetBytes(YOUR_IPN_SIGNING_KEY));\nvar hex = Convert.ToHexString(h.ComputeHash(rawBodyBytes)).ToLowerInvariant();\nvar ok = CryptographicOperations.FixedTimeEquals(\n            Encoding.UTF8.GetBytes(hex),\n            Encoding.UTF8.GetBytes(sigHeader.ToLowerInvariant()));\n\n
\n

فیلدهای payload

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
UniqueCodestringکد یکتای تراکنش (در v5 همان توکن GUID)
PaymentIdstringشناسه‌ی پرداخت شما
UserTelegramIdlongشناسه‌ی کاربر تلگرام
Walletstringکیف پول مقصد
Hashstringهش تراکنش (TXID) یا TrndOrderID_{orderId}
TronAmountdecimalمبلغ خالص تحویلی به شما (پس از کسر/جذب کارمزد)
ActualTronAmountdecimalمقدار ترون اولیه پیش از تعدیل احتمالی
UserPaidTomanAmountint🆕 v5 — مبلغی که کاربر واقعاً پرداخت کرد (با کارمزد). برای شارژ کاربر از این استفاده کنید
TomanAmountWithoutWageint🆕 v5 — مبلغ پایه‌ی تومانی بدون کارمزد
OrderStatusIDintشناسه‌ی عددی وضعیت سفارش. مقادیری که از طریق IPN ارسال می‌شوند:
۲۰ = WaitingForPayment (در انتظار عکس)
۲۵ = PhotoSentToAdmin (عکس ارسال شده به ادمین)
۲۷ = ReadyToTransfer (آماده برای انتقال ترون)
۳۰ = PaymentAccepted (تایید شده — پرداخت قطعی، IsPaid=true)
۴۰ = PaymentRejected (رد شده)
۲۰۰ = Cancelled (لغو شده)
OrderStatusTitlestringعنوان فارسی همان وضعیت (متناظر با OrderStatusID). صرفاً جهت نمایش است؛ منطق سمت پذیرنده باید روی OrderStatusID پیاده شود نه روی این متن.
نمونه‌ها: «در انتظار عکس»، «عکس ارسال شده به ادمین»، «آماده برای انتقال ترون»، «تایید شده»، «رد شده»، «لغو شده».
IsPaidboolپرداخت موفق؟
PaymentDatestringتاریخ/زمان وضعیت
\n
","urlObject":{"protocol":"https","path":["payment","callback"],"host":["your-domain","com"],"query":[],"variable":[]}},"response":[],"_postman_id":"54a25158-97e5-4726-9a96-f694af82dfe7"}],"id":"9288bde0-45e4-4380-9beb-31f16a9b5846","description":"

‫قرارداد callback (IPN). ترونادو نتیجه‌ی پرداخت را به CallbackUrl که در GetOrderToken دادید POST می‌کند. این فولدر صرفاً مستندسازی است — شما این درخواست را ارسال نمی‌کنید، بلکه آن را دریافت می‌کنید.

\n

‫نسخه‌ی v5 توصیه می‌شود: callback امضاشده (X-Tronado-Sig)، فیلدهای مبلغ تومانی، و ارسال به‌ازای هر تغییر وضعیت.

\n","_postman_id":"9288bde0-45e4-4380-9beb-31f16a9b5846"},{"name":"Price","item":[{"name":"Tron","item":[{"name":"GetPriceToToman","id":"4ee50120-4d07-404b-910c-a697db4f7aa8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://bot.tronado.cloud/Tron/GetPriceToToman","description":"

‫اولین endpoint قبل از ایجاد تراکنش. قیمت ترون در ترونادو با صرافی‌های دیگر متفاوت است؛ برای محاسبه‌ی درست مقدار ترون درخواستی، ابتدا قیمت را از اینجا بگیرید.

\n

📥 Header های لازم

\n
    \n
  • x-api-key
    • \n
  • Content-Type: application/json
    • \n
\n

‫بدون بدنه (no body).

\n

📤 پاسخ (Response 200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
NameTypeDescription
TronPriceTomanintقیمت ترون به تومان (نه ریال)
TronPriceDollardecimalقیمت ترون به دلار
\n
","urlObject":{"path":["Tron","GetPriceToToman"],"host":["https://bot.tronado.cloud"],"query":[],"variable":[]}},"response":[{"id":"e59590eb-9d0f-49c3-8d80-d0300f3bf22a","name":"200","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://bot.tronado.cloud/Tron/GetPriceToToman"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"TronPriceToman\": 34374,\n \"TronPriceDollar\": 0.339918584561496042492908269\n}"}],"_postman_id":"4ee50120-4d07-404b-910c-a697db4f7aa8"},{"name":"GetPriceWithWageToToman","id":"ca62f63f-54d5-45b1-912d-93505330c9b8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"RequestCode\": \"YOUR_REQUEST_CODE\",\n \"WalletAddress\": \"TXYZ12345abcdef...\",\n \"TronAmount\": 12.123456\n}","options":{"raw":{"language":"json"}}},"url":"https://bot.tronado.cloud/Tron/GetPriceWithWageToToman","description":"

‫مقدار ترون دلخواه را به تومان (همراه با کارمزد) برمی‌گرداند.

\n

📥 بدنه‌ی درخواست

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
RequestCodestringاز طریق پشتیبانی تهیه می‌شود
WalletAddressstringآدرس کیف پول مقصد
TronAmountdecimalمقدار ترون
\n

📤 پاسخ (Response 200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
NameTypeDescription
ActualAmountTomanintمقدار تومانی معادل ترون درخواستی (بدون کارمزد)
AmountWithWageTomanintمقدار تومانی همراه با کارمزد
\n
","urlObject":{"path":["Tron","GetPriceWithWageToToman"],"host":["https://bot.tronado.cloud"],"query":[],"variable":[]}},"response":[{"id":"b83f6fc4-520e-4963-ad6a-739b0eaf14cb","name":"200","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"RequestCode\": \"YOUR_REQUEST_CODE\",\n \"WalletAddress\": \"TXYZ12345abcdef...\",\n \"TronAmount\": 12.123456\n}","options":{"raw":{"language":"json"}}},"url":"https://bot.tronado.cloud/Tron/GetPriceWithWageToToman"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"ActualAmountToman\": 41250,\n \"AmountWithWageToman\": 43000\n}"}],"_postman_id":"ca62f63f-54d5-45b1-912d-93505330c9b8"}],"id":"2fc4d624-1ec8-43a6-a93c-055d8fa43806","_postman_id":"2fc4d624-1ec8-43a6-a93c-055d8fa43806","description":""},{"name":"Toman","item":[{"name":"ConvertToTronWageSubtracted","id":"7274674f-ee3f-4236-9ddd-72c72e1b397a","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"Toman\": 500000,\n \"Wallet\": \"TXYZ12345abcdef...\"\n}","options":{"raw":{"language":"json"}}},"url":"https://bot.tronado.cloud/Toman/ConvertToTronWageSubtracted","description":"

‫مقدار تومانی را گرفته و معادل ترون (بدون احتساب کارمزد) را برمی‌گرداند.

\n

📥 بدنه‌ی درخواست

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
Tomanintمقدار تومانی درخواستی
Walletstringآدرس کیف پول مقصد
\n

📤 پاسخ (Response 200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
NameTypeDescription
TronAmountdecimalمقدار ترون
TronSunAmountdecimalمقدار ترون به Sun
\n
","urlObject":{"path":["Toman","ConvertToTronWageSubtracted"],"host":["https://bot.tronado.cloud"],"query":[],"variable":[]}},"response":[{"id":"dd4907dc-c1ea-41e8-a1d5-21af67115419","name":"200","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"Toman\": 500000,\n \"Wallet\": \"TXYZ12345abcdef...\"\n}","options":{"raw":{"language":"json"}}},"url":"https://bot.tronado.cloud/Toman/ConvertToTronWageSubtracted"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"TronAmount\": 25.123456,\n \"TronSunAmount\": 25123456\n}"}],"_postman_id":"7274674f-ee3f-4236-9ddd-72c72e1b397a"},{"name":"GetPriceToToman (Dollar price)","id":"5ccab1d2-4840-4982-a0ce-54fb2b7b0ba8","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://bot.tronado.cloud/Toman/GetPriceToToman","description":"

‫قیمت دلار به تومان را برمی‌گرداند. بدون بدنه.

\n

📤 پاسخ (Response 200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
NameTypeDescription
DollarPriceintقیمت دلار به تومان
\n
","urlObject":{"path":["Toman","GetPriceToToman"],"host":["https://bot.tronado.cloud"],"query":[],"variable":[]}},"response":[{"id":"312ca4a8-c468-4abc-9749-ac81b4da9887","name":"200","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://bot.tronado.cloud/Toman/GetPriceToToman"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"DollarPrice\": 100783\n}"}],"_postman_id":"5ccab1d2-4840-4982-a0ce-54fb2b7b0ba8"}],"id":"4a9ed4ea-13b9-4aa9-a598-9a1a2df1fdf1","_postman_id":"4a9ed4ea-13b9-4aa9-a598-9a1a2df1fdf1","description":""},{"name":"Dollar","item":[{"name":"ConvertToTronWageSubtracted","id":"4c042148-1b4b-478b-91a0-824fc5b2bfed","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"Dollar\": 25.5,\n \"Wallet\": \"TXYZ12345abcdef...\"\n}","options":{"raw":{"language":"json"}}},"url":"https://bot.tronado.cloud/Dollar/ConvertToTronWageSubtracted","description":"

‫مقدار دلاری را گرفته و معادل ترون (بدون احتساب کارمزد) را برمی‌گرداند.

\n

📥 بدنه‌ی درخواست

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
Dollardecimalمقدار دلار
Walletstringآدرس کیف پول مقصد
\n

📤 پاسخ (Response 200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
TronAmountdecimalمقدار ترون
TronSunAmountdecimalمقدار ترون به Sun
\n
","urlObject":{"path":["Dollar","ConvertToTronWageSubtracted"],"host":["https://bot.tronado.cloud"],"query":[],"variable":[]}},"response":[{"id":"3f173d71-c923-4052-9fc8-48e1174619fd","name":"200","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"body":{"mode":"raw","raw":"{\n \"Dollar\": 25.5,\n \"Wallet\": \"TXYZ12345abcdef...\"\n}","options":{"raw":{"language":"json"}}},"url":"https://bot.tronado.cloud/Dollar/ConvertToTronWageSubtracted"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"TronAmount\": 25.123456,\n \"TronSunAmount\": 25123456\n}"}],"_postman_id":"4c042148-1b4b-478b-91a0-824fc5b2bfed"},{"name":"GetPriceToToman (Dollar price)","id":"b7101372-c376-4fdc-b025-96783fbdeeaa","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://bot.tronado.cloud/Dollar/GetPriceToToman","description":"

‫قیمت دلار به تومان را برمی‌گرداند. بدون بدنه.

\n

📤 پاسخ (Response 200)

\n
\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldTypeDescription
DollarPriceintقیمت دلار به تومان
\n
","urlObject":{"path":["Dollar","GetPriceToToman"],"host":["https://bot.tronado.cloud"],"query":[],"variable":[]}},"response":[{"id":"ad718706-a4fc-40fa-8e31-d4f4955eb34b","name":"200","originalRequest":{"method":"POST","header":[{"key":"x-api-key","value":""},{"key":"Content-Type","value":"application/json"}],"url":"https://bot.tronado.cloud/Dollar/GetPriceToToman"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[],"cookie":[],"responseTime":null,"body":"{\n \"DollarPrice\": 100783\n}"}],"_postman_id":"b7101372-c376-4fdc-b025-96783fbdeeaa"}],"id":"3300a7ff-2aa0-4996-8ad5-c313f22ffbfd","_postman_id":"3300a7ff-2aa0-4996-8ad5-c313f22ffbfd","description":""}],"id":"c74459c1-70c8-4b1f-9856-812642bfacab","description":"

‫دریافت قیمت‌ها و محاسبه‌ی مقدار ترون درخواستی (با و بدون کارمزد). همه‌ی این اندپوینت‌ها POST هستند و به Header x-api-key نیاز دارند.

\n","_postman_id":"c74459c1-70c8-4b1f-9856-812642bfacab"}],"variable":[{"key":"baseUrl","value":"https://bot.tronado.cloud"},{"key":"api-key","value":""}]}