پرداخت‌ها و موجودی

در GetMyBot دو «مدار پرداخت» مجزا وجود دارد: موجودی درخواست پلتفرم (برای کارکرد بات) و دریافت پرداخت از کاربران بات از طریق Telegram. بخش صورتحساب (همچنین «دریافت پرداخت‌ها») طرح‌ها و موجودی را مدیریت می‌کند.

نحوه محاسبه هزینه بات

پلتفرم کار را بر حسب درخواست حساب می‌کند: هر پیام تحویل‌داده‌شده توسط بات یک درخواست از موجودی حساب کسر می‌کند. موجودی یک شمارنده عدد صحیح است؛ منبع حقیقت گزارش تغییرناپذیر شارژ و کسر است (پاداش ثبت‌نام، شارژ طرح، شارژ دستی، مصرف).

طرح‌ها و موجودی

در بخش صورتحساب موجودی جاری و طرح‌های موجود نمایش داده می‌شوند. هر طرح دارای نام، قیمت و حجم درخواست، همچنین محدودیت‌ها (مثلاً حداکثر تعداد بات) است. با دکمه انتخاب طرح فعال می‌شود.

  • موجودی — موجودی جاری درخواست (در صفحه‌های نمای کلی و آمار نیز قابل مشاهده است).
  • پیش‌بینی، روز در صفحه آمار تخمین می‌زند با مصرف جاری موجودی تا چه مدت کافی است.

گزارش شارژ (ledger)

موجودی درخواست یک شمارنده عدد صحیح است، اما منبع حقیقت آن گزارش تغییرناپذیر عملیات (ledger) است. هر تغییر موجودی در آن ثبت می‌شود:

  • پاداش ثبت‌نام — حجم اولیه درخواست برای حساب جدید.
  • شارژ طرح — درخواست‌های اعطاشده هنگام فعال کردن طرح.
  • شارژ دستی — درخواست‌های خریداری‌شده.
  • مصرف — کسر یک درخواست برای هر پیام تحویل‌داده‌شده توسط بات.

گزارش فقط افزوده می‌شود (رکوردهای قدیمی تغییر نمی‌کنند)، بنابراین تاریخچه مصرف و شارژ همیشه قابل بررسی است. موجودی جاری مجموع گزارش است.

شارژ دستی

شارژ دستی یک پرداخت برای حجم مشخصی از درخواست ایجاد می‌کند؛ پس از تأیید ارائه‌دهنده، موجودی خودکار و idempotent شارژ می‌شود (کالبک تکراری باعث شارژ دوباره نمی‌شود). ارائه‌دهنده پرداخت بستگی به پیکربندی نمونه دارد.

دریافت پرداخت از کاربران (Telegram Payments)

بات می‌تواند پرداخت‌های Telegram را دریافت و ثبت کند:

  • درخواست pre_checkout_query به‌صورت خودکار تأیید می‌شود.
  • پرداخت موفق (successful_payment) ثبت می‌شود (مبلغ، ارز، شناسه تراکنش، payload) و سپس یک واکنش می‌تواند اجرا شود — مثلاً دسترسی بدهد، برچسب «پرداخت کرده» اضافه کند و سفارش را در مجموعه ثبت کند.

مجموع پرداخت‌های موفق در تحلیل‌ها («پرداخت‌ها») قابل مشاهده است.

صدور فاکتور (sendInvoice) و دکمه‌های «دریافت پرداخت» / «اعلان» در سازنده دکمه‌ها فعلاً به‌زودی علامت‌گذاری شده‌اند: بات پرداخت‌های ورودی را ثبت می‌کند، اما در نسخه فعلی نمی‌توان از واکنش فاکتور صادر کرد.

بیشتر بخوانید