Rayno DocsRayno Cloud v2.2.0
docsbilling

کیف پول و صورتحساب

تعرفه تومانی، شارژ کیف پول، فاکتورها و چرخه حیات حساب.

صورتحساب پلتفرم کاملاً مصرف‌محور و به تومان است. هیچ هزینه ثابت ماهانه یا هزینه راه‌اندازی وجود ندارد.

مدل هزینه

هزینه ساعتی از جمع چهار مؤلفه به دست می‌آید:

hourly = cpu_cores × cpu_per_core_hour
       + ram_gb    × ram_per_gb_hour
       + disk_gb   × disk_per_gb_hour
       + backup_gb × backup_per_gb_hour

نرخ‌ها را می‌توانید در صفحه تعرفه‌های وب‌سایت یا در پاسخ GET /pricing/current ببینید. نرخ‌های فعال در صفحه تعرفه‌های راینو کلاد و پاسخ سرویس تعرفه نمایش داده می‌شوند.

شارژ کیف پول

  1. در کنسول به کیف پول بروید.
  2. مبلغ را به تومان وارد کنید (یا مبلغ پیشنهادی انتخاب کنید). حداقل شارژ ۱۰٬۰۰۰ تومان و
  3. حداکثر ۵۰۰٬۰۰۰٬۰۰۰ تومان است.

  4. شارژ کیف پول را بزنید.

سرور یک فاکتور TOPUP با وضعیت PENDING می‌سازد و آدرس بازگشت درگاه را برمی‌گرداند. پس از پرداخت موفق، موجودی به‌صورت اتمیک اضافه می‌شود و تراکنش در دفتر کل ثبت می‌گردد.

POST /api/v1/wallet/topup
{
  "amount": 250000,
  "return_url": "https://console.rayno.cloud/wallet/topup/callback"
}
در محیط توسعه، درگاه MOCK است و بازگشت به /wallet/topup/callback بلافاصله کیف پول را شارژ می‌کند.

چرخه حیات کیف پول

وضعیتمعنیاثر
ACTIVEموجودی کافی استهمه سرویس‌ها فعال
LOW_BALANCEزیر آستانه هشداراعلان و هشدار در کنسول
GRACEموجودی صفرمهلت ۴۸ ساعته برای شارژ
SUSPENDEDپایان دوره تنفستوقف سرویس‌ها
TERMINATEDپایان نگهداریحذف منابع

آستانه هشدار، مبلغ هشدار موجودی کم، مدت مهلت (پیش‌فرض ۴۸ ساعت) و مدت نگهداری داده‌ها در صفحه تعرفه‌های پلتفرم تنظیم می‌شوند و ممکن است با مقدار پیش‌فرض متفاوت باشند. مقادیر فعلی را همیشه در صفحه تعرفه‌ها ببینید.

فاکتورها

  • USAGE: صورتحساب مصرف دوره‌ای.
  • TOPUP: شارژ کیف پول.
  • ADJUSTMENT: تعدیل دستی توسط تیم مالی.

هر فاکتور شماره یکتا، subtotal، tax، total و وضعیت (PENDING، PAID، VOID، REFUNDED) دارد. از کنسول می‌توانید فاکتور را مشاهده و چاپ کنید.

rayno wallet show
rayno wallet invoices
rayno wallet transactions

تراکنش‌ها

هر تغییر موجودی یک ردیف در دفتر کل می‌سازد:

GET /api/v1/wallet/transactions?limit=100

هر ردیف شامل amount، balance_after، kind، description و created_at است. خروجی CSV نیز از کنسول قابل دریافت است.

تخمین هزینه

از صفحه محاسبه‌گر در لندینگ (/calculator) یا API عمومی:

POST /api/v1/pricing/calculate
{
  "cpu_cores": 2,
  "ram_gb": 4,
  "disk_gb": 40,
  "wallet_balance": 250000
}

پاسخ شامل hourly_cost، daily_cost، monthly_cost، runway_days و ریز اقلام است.

نکات

  • مصرف به‌صورت ساعتی محاسبه می‌شود؛ منابعی که حذف می‌کنید از ساعت بعد صورتحساب حذف می‌شوند.
  • مقیاس‌دهی رو به بالا هزینه را افزایش می‌دهد؛ کاهش منابع مجاز نیست.
  • برای جلوگیری از تعلیق ناخواسته، آستانه هشدار را متناسب با مصرف تنظیم کنید.
آخرین به‌روزرسانی: مستندات نسخه پلتفرم (Rayno Cloud v2.2.0)مشکلی در مستندات پیدا کردید؟ تیکت بزنید