درگاه TonPays

TonPays یک درگاه پرداخت شخص ثالث است که کاربر با آن به تومان پرداخت می‌کند و کیف پولش در ربات شارژ می‌شود. تنظیماتش در مسیر پنل مدیریت → 💳 تنظیمات درگاه → 💎 درگاه TonPays است.

صفحهٔ تنظیمات

دو نوع درگاه: معمولی و کاستوم

با دکمهٔ 🧬 نوع: … (تغییر) بین دو حالت جابه‌جا می‌شوید:

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

کلیدها

1. کلید را از پنل فروشگاه TonPays بردارید (تنظیمات ← کلید API).
2. در ربات 🔑 کلید معمولی یا 🔑 کلید کاستوم را بزنید و کلید را بفرستید.

• کلید باید حداکثر ۲۵۶ کاراکتر و بدون فاصله باشد. در غیر این صورت پیام ❌ کلید نامعتبر است. دوباره ارسال کنید. را می‌گیرید.
• بلافاصله بعد از ذخیره، ربات اتصال را تست می‌کند و نتیجه را با 🟢 یا 🔴 نشان می‌دهد.
• در صفحهٔ تنظیمات فقط چهار کاراکتر اول و آخر کلید نمایش داده می‌شود.
• درگاه فقط وقتی برای کاربر آماده است که روشن باشد و کلید نوع انتخاب‌شده تنظیم شده باشد.

🧪 تست اتصال

این دکمه با کلیدِ نوعِ انتخاب‌شده یک درخواست آزمایشی به TonPays می‌فرستد و نتیجه را در یک پیام کوتاه نشان می‌دهد:

• ✅ اتصال برقرار است و کلید معتبر است.
• یا پیام خطای TonPays، مثلاً «کلید API درگاه TonPays نامعتبر است.»، «حساب TonPays هنوز تأیید نشده است.» یا «درگاه کاستوم TonPays هنوز تأیید نشده است.»

اگر کلید نوع فعلی خالی باشد، پیام کلید درگاه انتخاب‌شده تنظیم نشده است. را می‌گیرید.

روشن و خاموش کردن

دکمهٔ ✅ روشن کردن درگاه / ❌ خاموش کردن درگاه درگاه را فعال یا غیرفعال می‌کند. هنگام روشن کردن، متن کوتاه سلب مسئولیت نمایش داده می‌شود. همین کلید در ⚙️ تنظیمات ربات → 💳 پرداخت‌ها و روش‌های شارژ با نام درگاه TonPays هم وجود دارد و هر دو یک تنظیم را تغییر می‌دهند.

💰 محدوده مبلغ شارژ

ربات اول حداقل و بعد حداکثر مبلغ را به تومان می‌پرسد. حداکثر نباید کمتر از حداقل باشد. ویرگول در عدد مشکلی ندارد. پیش‌فرض: ۵۰,۰۰۰ تا ۱۰,۰۰۰,۰۰۰ تومان. این محدوده جدا از محدودیت کارت دستی و ارزی است.

TonPays هم ممکن است حداقل و حداکثر خودش را داشته باشد. اگر مبلغ خارج از محدودهٔ TonPays باشد، کاربر پیام خطای مربوط را می‌گیرد.

🎁 بونوس

• 🎁 بونوس ✅/❌: روشن یا خاموش کردن بونوس شارژ TonPays.
• 📝 درصد بونوس: عددی بین ۰ تا ۱۰۰.

با بونوس ۵٪ و شارژ ۱۰۰,۰۰۰ تومان، ۱۰۵,۰۰۰ تومان به کیف پول اضافه می‌شود.

وب‌هوک و تایید پرداخت

TonPays بعد از پرداخت می‌تواند به ربات خبر بدهد (وب‌هوک). آدرس وب‌هوک در صفحهٔ تنظیمات نمایش داده می‌شود:

https://YOUR_WEBAPP_DOMAIN/api/payments/tonpays/callback

• این آدرس فقط وقتی ساخته می‌شود که WEBAPP_URL با https:// تنظیم شده باشد. ربات این آدرس را خودکار همراه هر فاکتور به TonPays می‌فرستد. اگر پنل TonPays جایی برای ثبت آدرس وب‌هوک دارد، همین آدرس را آنجا هم بگذارید.
• اگر WEBAPP_URL با https تنظیم نشده باشد، به‌جای آدرس پیام ⚠️ WEBAPP_URL با https تنظیم نشده؛ تأیید فقط با استعلام دوره‌ای انجام می‌شود. را می‌بینید. درگاه همچنان کار می‌کند، فقط تایید کمی دیرتر انجام می‌شود.
• استعلام دوره‌ای: ربات هر ۶۰ ثانیه وضعیت فاکتورهای باز را از TonPays می‌پرسد (هر بار حداکثر ۳۰ فاکتور). این کار حتی وقتی وب‌هوک فعال است هم انجام می‌شود تا اگر وب‌هوکی نرسید، پرداخت از دست نرود.
• به خودِ پیام وب‌هوک اعتماد نمی‌شود. ربات همیشه وضعیت فاکتور را دوباره از TonPays می‌خواند و فقط وقتی TonPays تایید کند، کیف پول را شارژ می‌کند. هر فاکتور فقط یک بار شارژ می‌شود.

راهنمای تنظیم WEBAPP_URL و دامنه در پیکربندی آمده است.

از دید کاربر

1. کاربر در 💰 افزایش موجودی روش TonPays را انتخاب و مبلغ را وارد می‌کند.
2. در حالت معمولی لینک پرداخت در ربات یا صفحهٔ TonPays را می‌گیرد. در حالت کاستوم شماره کارت را می‌بیند، واریز می‌کند و عکس رسید را می‌فرستد (حداکثر ۱۰ مگابایت).
3. بعد از تایید TonPays، کیف پول شارژ می‌شود و کاربر پیامی با مبلغ شارژ، بونوس و موجودی جدید می‌گیرد.

قواعدی که خوب است بدانید:

• هر کاربر هم‌زمان حداکثر ۳ فاکتور باز می‌تواند داشته باشد.
• مبلغ پرداختی ممکن است کمی با مبلغ شارژ فرق داشته باشد. TonPays مبلغ نهایی پرداخت را تعیین می‌کند، ولی کیف پول به اندازهٔ مبلغ شارژ (به همراه بونوس) شارژ می‌شود.
• فاکتوری که بعد از ۲۴ ساعت هنوز باز باشد، در ربات بسته و منقضی می‌شود.
• اگر TonPays وضعیت فاکتور را «نیاز به اقدام» اعلام کند، کاربر پیامی می‌گیرد که فیش را بررسی کند یا با پشتیبانی تماس بگیرد.
• ساخت فاکتور و شارژ موفق در مقصد لاگ‌های ارزی ثبت می‌شوند.

راهنمای کامل کاربر: افزایش موجودی.

مرتبط