پرداخت کریپتو برای WHMCS
روی فاکتورهای WHMCS کریپتو دریافت کنید. مشتری روی Pay Now می‌زند، در صفحه SnapEX Pay با USDT در شبکه‌های TRON، Ethereum، BSC و شبکه‌های دیگر، یا با کوین‌های دیگر با تبدیل به USDT پرداخت میکند و فاکتور در WHMCS بهطور خودکار پرداختشده علامت میخورد.
رایگان. نسخه 1.1.0.
چه کاری انجام می‌دهد
- بدون نیاز به کیف پول یا نود: وجه به موجودی فروشنده SnapEX Pay شما واریز میشود.
- سه راه مستقل برای پرداختشده علامت خوردن فاکتور: وبهوک امضاشده، بازگشت مشتری از صفحه پرداخت و بررسی پس‌زمینه در اجراهای cron در WHMCS (هر پرداخت در انتظار حداکثر هر ۱۰ دقیقه یک بار، به مدت ۵ روز). گم شدن وبهوک هرگز فاکتور پرداختشده را پرداخت‌نشده باقی نمی‌گذارد و هیچ پرداختی دو بار ثبت نمیشود.
- WHMCS چندارزی: با تنظیم Convert To For Processing روی USD، فاکتورها همچنان به ارز مشتری ثبت میشوند.
- پرداخت‌های ناقص هرگز خودکار اعمال نمی‌شوند: برای بررسی شما به Gateway Log می‌روند. اگر وبهوک تنظیم شده باشد، پولی که پس از بسته شدن فاکتور SnapEX Pay برسد هم آنجا ثبت میشود.
- حالت تست: فاکتورهای تست بدون پول واقعی خودبهخود تأیید میشوند؛ تا وقتی روشن است، فقط ادمینهای واردشده دکمه پرداخت را میبینند و سایر مشتریان به‌جای آن پیام «test mode» را میبینند.
نصب
- محتوای آرشیو را با حفظ مسیرها در پوشه اصلی WHMCS آپلود کنید:
modules/gateways/snapexpay.php،modules/gateways/snapexpay/،modules/gateways/callback/snapexpay.php،includes/hooks/snapexpay.php. - در پنل ادمین WHMCS به System Settings → Payment Gateways → All Payment Gateways بروید و SnapEX Pay (Crypto) را فعال کنید.
- در پنل فروشنده SnapEX Pay یک کلید API با دسترسی‌های
invoices.readوinvoices.writeبسازید و در فیلد API key وارد کنید. - وبهوک (توصیه‌شده): در پنل آدرس وبهوک را
https://<your WHMCS>/modules/gateways/callback/snapexpay.phpقرار دهید (آدرس دقیق زیر فیلد در WHMCS نمایش داده میشود) و رمزwhsec_…را در Webhook secret وارد کنید. - اگر ارز WHMCS شما USD نیست، Convert To For Processing را روی USD تنظیم کنید. فاکتورها همچنان به ارز مشتری ثبت میشوند.
- حالت تست را روشن کنید، به‌عنوان ادمین یک فاکتور پرداخت‌نشده باز کنید، آن را در صفحه SnapEX Pay با یک روش تست بپردازید و بررسی کنید که Paid شود. سپس حالت تست را خاموش کنید.
تنظیمات
| API key | از پنل SnapEX Pay. |
|---|---|
| Webhook secret | whsec_… از تنظیمات وبهوک پنل. بدون آن، ماژول همچنان از طریق صفحه بازگشت و cron کار میکند. |
| Network fee paid by | Merchant: مشتری دقیقاً مبلغ فاکتور را می‌پردازد و کارمزد از مبلغ دریافتی شما کسر میشود. Client: کارمزد SnapEX Pay و کارمزد شبکه به آن اضافه میشوند. |
| Payment window, minutes | مدت اعتبار صفحه پرداخت (۱ تا ۱۴۴۰، پیش‌فرض ۶۰). زدن دوباره Pay Now بعداً یک صفحه تازه باز میکند. |
| Test mode | فاکتورهای تست؛ تا وقتی روشن است فقط ادمین‌ها دکمه پرداخت را میبینند. پس از خاموش شدن حالت تست، پرداخت‌های تست نادیده گرفته میشوند. |
| Partner ID | اختیاری: Partner ID یکپارچه‌سازی که ماژول را راه‌اندازی کرده است (برنامه معرفی SnapEX Pay). اگر خودتان نصب می‌کنید، خالی بگذارید. |
| API URL | بدون تغییر بگذارید. |
سؤالات
اگر وبهوک نرسد چه میشود؟
فاکتور همچنان پرداختشده علامت میخورد: ماژول پرداخت را هنگام بازگشت مشتری از صفحه پرداخت و در اجراهای cron در WHMCS هم بررسی میکند (هر پرداخت در انتظار حداکثر هر ۱۰ دقیقه یک بار، به مدت ۵ روز). هیچ پرداختی دو بار ثبت نمیشود.
ارز WHMCS من USD نیست. کار میکند؟
بله. در تنظیمات درگاه Convert To For Processing را روی USD بگذارید؛ فاکتورها همچنان به ارز مشتری ثبت میشوند.
اگر مشتری کمتر از مبلغ فاکتور بفرستد چه؟
اگر مشتری بهموقع بقیه را نپردازد، چیزی بهطور خودکار ثبت نمیشود. در Gateway Log یک ورودی "Partial payment — review and apply manually" با مبلغ دریافتی ثبت میشود.
اگر پول پس از بسته شدن فاکتور SnapEX Pay برسد چه؟
در WHMCS خودکار اعمال نمیشود. اگر وبهوک تنظیم شده باشد، یک ورودی در Gateway Log ثبت میشود؛ پول در موجودی SnapEX Pay شما است.
آیا میتوانم بدون پول واقعی تست کنم؟
بله. حالت تست را روشن کنید: فاکتورهای تست خودبهخود تأیید میشوند و تا وقتی روشن است فقط ادمینهای واردشده دکمه پرداخت را میبینند.
کارهای ماژول را کجا ببینم؟
در WHMCS، بخش Billing → Gateway Log. شناسه تراکنش هر پرداخت، شناسه فاکتور SnapEX Pay (inv_…) است.
یکپارچه‌سازی‌های دیگر
آماده دریافت کریپتو هستید؟
حساب فروشنده بسازید، کلید API بگیرید و ماژول را وصل کنید. 1٪ برای هر پرداخت، بدون هزینه ماهانه.