پرداخت کریپتو برای BILLmanager
در BILLmanager کریپتو دریافت کنید. مشتری هنگام شارژ موجودی یا پرداخت سفارش SnapEX Pay (crypto) را انتخاب میکند، در صفحه SnapEX Pay با USDT در شبکه‌های TRON، Ethereum، BSC و شبکه‌های دیگر، یا با کوین‌های دیگر با تبدیل به USDT پرداخت میکند و پرداخت به‌طور خودکار در BILLmanager ثبت میشود.
رایگان. نسخه 1.1.0.
چه کاری انجام می‌دهد
- بدون نیاز به کیف پول یا نود: وجه به موجودی فروشنده SnapEX Pay شما واریز میشود.
- سه راه مستقل برای ثبت پرداخت: وب‌هوک امضاشده، بازگشت مشتری از صفحه پرداخت و بررسی دوره‌ای (
checkpay). گم شدن وب‌هوک هرگز پرداخت انجام‌شده را ثبت‌نشده باقی نمی‌گذارد و هیچ پرداختی دو بار ثبت نمیشود. - مبلغ همیشه دوباره از API SnapEX Pay خوانده میشود؛ بدنه وب‌هوک به‌تنهایی هرگز چیزی را ثبت نمی‌کند.
- پرداخت‌های ناقص به‌طور خودکار ثبت نمی‌شوند: لاگ از شما می‌خواهد آن‌ها را بررسی کنید.
- حالت تست: فاکتورهای تست بدون پول واقعی خودبه‌خود تأیید میشوند و پس از خاموش شدن حالت تست هرگز ثبت نمی‌شوند.
نصب
- روی سرور BILLmanager با کاربر root:
tar xzf snapexpay-billmanager-1.1.0.tar.gz،cd snapexpay-billmanager-1.1.0،sh install.sh. این اسکریپت ماژول را در/usr/local/mgr5کپی میکند، یک cron پشتیبانcheckpayهر ۵ دقیقه (/etc/cron.d/snapexpay) اضافه میکند و BILLmanager را ری‌استارت میکند. - در پنل فروشنده SnapEX Pay یک کلید API با دسترسی‌های
invoices.readوinvoices.writeبسازید. - BILLmanager → Provider → Payment methods → Add → SnapEX Pay (crypto). ارز: USD. کلید API را وارد کنید؛ هنگام ذخیره با SnapEX Pay بررسی میشود.
- وب‌هوک (توصیه‌شده): در پنل آدرس وب‌هوک را
https://<your billing domain>/mancgi/snapexpayresultقرار دهید و رمزwhsec_…را در Webhook secret وارد کنید. - مشتریانی که با ارزهای دیگر پرداخت میکنند: BILLmanager مبلغ را با نرخهای خودش به ارز روش پرداخت (USD) تبدیل میکند، پس نرخ USD را بهروز نگه دارید.
- ابتدا تست کنید: یک روش پرداخت جداگانه با Test mode روشن که فقط برای یک مشتری تست در دسترس باشد (Payment methods → محدودیت بر اساس گروه مشتری). سپس حالت تست را خاموش یا آن روش را حذف کنید.
تنظیمات
| API key | از پنل SnapEX Pay. |
|---|---|
| Webhook secret | whsec_… از تنظیمات وب‌هوک پنل. بدون آن، پرداختها همچنان هنگام بازگشت مشتری و با بررسی دوره‌ای ثبت میشوند. |
| Client pays the network fee | خاموش: مشتری دقیقاً مبلغ پرداخت را می‌پردازد و کارمزد از مبلغ دریافتی شما کسر میشود. روشن: کارمزد SnapEX Pay و کارمزد شبکه به آن اضافه میشوند. |
| Payment window, minutes | مدت اعتبار صفحه پرداخت SnapEX (۱ تا ۱۴۴۰، پیش‌فرض ۶۰). باز کردن دوباره پرداخت بعداً یک صفحه تازه می‌سازد. |
| Test mode | فاکتورهای تست بدون پول واقعی. پس از خاموش شدن، پرداخت‌های تست هرگز ثبت نمی‌شوند. |
| API URL | خالی بگذارید. |
| Partner ID | اختیاری: Partner ID یکپارچه‌سازی که ماژول را راه‌اندازی کرده است (برنامه معرفی SnapEX Pay). اگر خودتان نصب می‌کنید، خالی بگذارید. |
سؤالات
کدام نسخههای BILLmanager پشتیبانی میشوند؟
BILLmanager 6، هر نسخه. ماژول فقط به python3 3.6+ با کتابخانه استاندارد روی سرور BILLmanager نیاز دارد.
اگر وب‌هوک نرسد چه میشود؟
پرداخت همچنان هنگام بازگشت مشتری از صفحه پرداخت یا با بررسی دوره‌ای که هر ۵ دقیقه اجرا میشود ثبت میشود. هیچ پرداختی دو بار ثبت نمیشود.
مشتریانم با روبل یا ارزهای دیگر پرداخت میکنند. کار میکند؟
بله. روش پرداخت به USD است و BILLmanager مبلغ را با نرخهای خودش تبدیل میکند؛ نرخ USD را بهروز نگه دارید.
اگر مشتری کمتر از مبلغ لازم بفرستد چه؟
اگر مشتری بهموقع بقیه را نپردازد، چیزی ثبت نمیشود و لاگ مینویسد "closed with a PARTIAL payment (…) - review in SnapEX Pay and credit manually".
اگر مشتری بهموقع پرداخت نکند چه؟
پرداخت در وضعیت "In payment" میماند تا مشتری دوباره تلاش کند؛ یک روز پس از انقضای آخرین فاکتور SnapEX لغو میشود.
چگونه ماژول را حذف کنم؟
sh install.sh --uninstall را اجرا کنید. تاریخچه پرداختها در var/snapexpay.sqlite میماند. همه کارهای ماژول در /usr/local/mgr5/var/pmsnapexpay.log ثبت میشود.
یکپارچه‌سازی‌های دیگر
آماده دریافت کریپتو هستید؟
حساب فروشنده بسازید، کلید API بگیرید و ماژول را وصل کنید. 1٪ برای هر پرداخت، بدون هزینه ماهانه.