پرداخت کریپتو برای Xboard و V2Board
یک افزونه پرداخت برای پنل‌های VPN و پروکسی Xboard و V2Board. در صفحه پرداخت، مشتری به صفحه SnapEX Pay می‌رود، با USDT در TRC20، ERC20 یا BEP20 (یا روش دیگری که SnapEX برای آن مبلغ ارائه می‌دهد) پرداخت میکند و سفارش پس از یک وبهوک امضاشده به‌طور خودکار باز میشود. بدون کیف پول، نود یا درگاه روی سرور خودتان؛ وجه به موجودی فروشنده SnapEX Pay شما واریز میشود.
رایگان. نسخه 1.1.0.
چه کاری انجام می‌دهد
- افزونه بومی Xboard (قابل نصب از مدیر افزونه‌های پنل ادمین) به‌علاوه کلاس
app/Payments/SnapexPay.phpبرای V2Board و نسخههای قدیمیتر Xboard. - واحد پول درست: مبالغ پنل به سنت، به‌صورت مبلغ اعشاری دلار ارسال می‌شوند، با نرخ اختیاری برای فروشگاه‌هایی که به دلار قیمت ندارند.
- وب‌هوک‌های امضاشده (HMAC-SHA256، بازه ۵ دقیقه)؛ فاکتور دوباره از API SnapEX Pay خوانده میشود و سفارش فقط وقتی پرداخت‌شده میشود که وضعیت paid باشد.
- کلیک دوباره روی Pay از همان فاکتور استفاده میکند؛ اگر منقضی شده باشد، فاکتور تازهای برای همان سفارش باز میشود. فاکتورهای تست هرگز نمی‌توانند سفارشی را باز کنند وقتی روش پرداخت در حالت live است.
- بازه پرداخت کمتر از زمان لغو سفارش خود پنل محدود شده است، پس مشتری نمی‌تواند سفارشی را که پنل لغو کرده بپردازد. فقط PHP و cURL، بدون وابستگی اضافی.
نصب
- Xboard: ادمین → Plugins → ZIP دانلودشده را آپلود کنید → Install → "SnapEX Pay" را Enable کنید. (یا آن را از حالت فشرده خارج کنید و پوشه را به‌صورت
plugins/Snapexpay/در پنل قرار دهید — نام به حروف بزرگ و کوچک حساس است — سپس از Plugins نصب کنید.) - V2Board یا Xboard قدیمیتر: فایل
app/Payments/SnapexPay.phpرا از آرشیو در پنل کپی کنید و اگر از OPcache استفاده می‌کنید PHP-FPM یا Octane را ری‌استارت کنید؛ در V2Board مطمئن شوید Site URL (app_url) تنظیم شده است. - Payment configuration → Add payment method → درگاه SnapexPay. کلید API (دسترسی‌های
invoices.read،invoices.write) را از پنل SnapEX Pay وارد کنید. - notify URL که پنل برای این روش نشان می‌دهد را کپی کنید، آن را به‌عنوان endpoint وبهوک در پنل SnapEX Pay اضافه کنید و رمز
whsec_…آن را در Webhook secret وارد کنید. - اگر قیمت‌ها به دلار نیستند، "USD per 1 shop currency" را تنظیم کنید (مثلاً
0.14برای CNY). ذخیره کنید و یک پرداخت را تست کنید.
تنظیمات
| API key | پنل SnapEX Pay → API keys، دسترسی‌های invoices.read و invoices.write. |
|---|---|
| Webhook secret | رمز whsec_… مربوط به endpoint وبهوک. بدون امضای معتبر هیچ سفارشی پرداخت‌شده نمی‌شود. |
| Network fee paid by | merchant: مشتری دقیقاً مبلغ سفارش را می‌پردازد. customer: کارمزد شبکه به آن اضافه میشود. |
| Payment window, minutes | پیش‌فرض Xboard برابر 60 (حداکثر 120)، پیش‌فرض V2Board برابر 20 (حداکثر 30) — کمتر از زمان لغو سفارش خود پنل‌ها. |
| USD per 1 shop currency | 1 برای قیمتهای دلاری؛ مثلاً 0.14 برای CNY. |
سؤالات
با V2Board کار میکند؟
بله. Xboard یک افزونه بومی دارد؛ V2Board و نسخههای قدیمیتر Xboard از کلاس app/Payments/SnapexPay.php با همان تنظیمات استفاده میکنند.
قیمتهای من به CNY یا ارز دیگری است.
"USD per 1 shop currency" را تنظیم کنید: مبلغ برابر total / 100 × usd_rate است، مثلاً 0.14 برای CNY.
اگر مشتری دو بار روی Pay کلیک کند چه میشود؟
از همان فاکتور استفاده میشود؛ اگر منقضی شده باشد، فاکتور تازهای برای همان سفارش باز میشود.
چرا بازه پرداخت محدود است؟
Xboard سفارشهای پرداختنشده را پس از ۲ ساعت و V2Board پس از ۳۰ دقیقه لغو میکند، پس بازه کمتر از آن محدود شده تا مشتری نتواند سفارش لغوشده را بپردازد.
چرا به HTTPS نیاز دارم؟
SnapEX Pay وبهوکها را فقط به آدرسهای HTTPS عمومی میفرستد و سفارش با وبهوک باز میشود.
یکپارچه‌سازی‌های دیگر
آماده دریافت کریپتو هستید؟
حساب فروشنده بسازید، کلید API بگیرید و ماژول را وصل کنید. 1٪ برای هر پرداخت، بدون هزینه ماهانه.