پرداخت رمزارزی برای WISECP
روی فاکتورها و سفارش‌های WISECP رمزارز بپذیرید. مشتری گزینهٔ SnapEX Pay — crypto (USDT and other coins) را انتخاب می‌کند، در صفحهٔ پرداخت SnapEX Pay با USDT در شبکه‌های TRON، Ethereum، BSC و دیگر شبکه‌ها یا با کوین‌های دیگری که به USDT تبدیل می‌شوند پرداخت می‌کند و فاکتور در WISECP به‌طور خودکار پرداختشده علامت می‌خورد.
چه کاری انجام می‌دهد
- نیازی به نگهداری کیف پول یا نود نیست: وجوه به موجودی مرچنت شما در SnapEX Pay واریز میشود.
- پرداخت با وبهوک امضاشده یا به محض بازگشت مشتری از صفحهٔ پرداخت ثبت میشود، هر کدام زودتر رخ دهد. در هر دو حالت فاکتور ابتدا دوباره از API SnapEX Pay خوانده میشود: بدنهٔ وبهوک به‌تنهایی هیچ چیزی را پرداختشده علامت نمی‌زند و هیچ پرداختی دو بار ثبت نمیشود.
- مشتری‌ای که پیش از تأیید پرداخت برگردد، صفحهٔ وضعیتی می‌بیند که هر ۱۰ ثانیه دوباره بررسی می‌کند و خودش به صفحهٔ «پرداخت موفق» WISECP می‌رود.
- پرداخت‌های ناقص با وضعیت در انتظار (pending) و با مبلغ دریافتی در یادداشت پرداخت گزارش می‌شوند تا پیش از تأیید بررسی کنید.
- حالت آزمایشی: فاکتورهای آزمایشی بدون پول واقعی خودبه‌خود تأیید می‌شوند؛ تا وقتی این حالت روشن است، فقط مدیرِ واردشده دکمه را می‌بیند.
- بدون جدول اضافه در پایگاه داده: ماژول داده‌هایش را در checkout WISECP نگه می‌دارد. متن‌های پنل مدیریت به انگلیسی، ترکی و روسی.
- کوین‌ها: USDT (TRC20، ERC20، BEP20) برای فاکتور با هر مبلغی؛ BTC، ETH، LTC و TRX در فاکتورهای کوچک‌تر هم، اگر کارمزد شبکه اجازه دهد؛ کوین‌های دیگر برای فاکتورهای از $۸ به بالا.
نصب
- محتوای آرشیو را با حفظ مسیر
coremio/modules/Payment/SnapexPay/در پوشهٔ ریشهٔ WISECP بارگذاری کنید. - در پنل مدیریت WISECP تنظیمات درگاه‌های پرداخت را باز کنید، SnapEX Pay (Crypto) را میان ماژول‌ها پیدا کنید، فعالش کنید و تنظیماتش را باز کنید. در WISECP 5: Payment Gateways ← آن را در Enabled Module Selection اضافه کنید، ذخیره کنید و سپس کارتش را باز کنید.
- در پنل مرچنت SnapEX Pay یک کلید API با دسترسی‌های
invoices.readوinvoices.writeبسازید و در فیلد API key قرار دهید. - در پنل یک وبهوک با آدرسی که زیر فیلد Webhook secret نشان داده میشود اضافه کنید (
https://<WISECP شما>/payment/SnapexPay/<token>/callbackدر WISECP 3 و…/payments/SnapexPay/<token>/callbackدر WISECP 5؛ آن را از صفحهٔ تنظیمات کپی کنید) و رمزwhsec_…را در Webhook secret قرار دهید. وقتی مشتری به سایت برنمی‌گردد، پرداخت از طریق وبهوک میرسد. - اگر فاکتورهای شما به USD نیستند، USD را با نرخ تبدیل در میان ارزهای WISECP نگه دارید: ماژول مبلغ را با نرخ‌های WISECP به USD تبدیل می‌کند. اگر درگاه را روی تبدیل به USD تنظیم کنید، WISECP مبلغ را به USD می‌فرستد و تبدیلی لازم نیست.
- Test mode را روشن کنید، در پنل مدیریت واردشده بمانید، در همان مرورگر یک فاکتور پرداخت‌نشده را در بخش مشتری باز کنید، آن را در صفحهٔ SnapEX Pay با یک روش آزمایشی پرداخت کنید و بررسی کنید که پرداختشده شود. سپس حالت آزمایشی را خاموش کنید.
تنظیمات
| API key | از پنل SnapEX Pay. |
|---|---|
| Webhook secret | whsec_… از تنظیمات وبهوک در پنل. آدرس وبهوک زیر همین فیلد نشان داده میشود. |
| Network fee paid by | Merchant: مشتری دقیقاً مبلغ فاکتور را می‌پردازد. Client: کارمزد به مبلغ اضافه میشود. |
| Payment window, minutes | مدت اعتبار صفحهٔ پرداخت (۱ تا ۱۴۴۰، پیش‌فرض ۶۰). پرداخت دوباره در زمان بعدی صفحهٔ تازه‌ای باز می‌کند. |
| Test mode | فاکتورهای آزمایشی، فقط برای مدیرانِ واردشده. پس از خاموش کردن این حالت، پرداخت‌های آزمایشی نادیده گرفته می‌شوند. |
| Partner ID | اختیاری: Partner ID یکپارچه‌سازی که ماژول را راه‌اندازی کرده است (برنامهٔ معرفی SnapEX Pay). اگر خودتان نصب می‌کنید، خالی بگذارید. |
| API URL | تغییر ندهید. |
سؤالات
با کدام نسخه‌های WISECP کار می‌کند؟
با WISECP 3 و WISECP 5. در یک نصب واقعی WISECP 5.0-beta.3 از ابتدا تا انتها بررسی شده است: وبهوک، بازگشت مشتری و وبهوک دیررس پس از بازگشت — در هر حالت فقط یک پرداخت.
چرا وبهوک را اضافه کنم؟
اگر مشتری پرداخت کند و به سایت برنگردد، پرداخت از طریق وبهوک امضاشده به WISECP میرسد. اگر مشتری برگردد، پرداخت فوراً ثبت میشود و هرگز دو بار ثبت نمیشود.
فاکتورهای من به USD نیستند. کار می‌کند؟
بله. USD را با نرخ تبدیل در میان ارزهای WISECP نگه دارید تا ماژول مبلغ را با نرخ‌های WISECP تبدیل کند. یا درگاه را روی تبدیل به USD تنظیم کنید تا WISECP مبلغ را به USD بفرستد.
پس از پرداخت فاکتور در WISECP چه ثبت میشود؟
پرداخت موفق گزارش میشود و WISECP فاکتور (یا سفارش) را پرداختشده علامت میزند. شناسهٔ تراکنش شمارهٔ فاکتور SnapEX Pay (INV-…) است و در یادداشت پرداخت آمده که مشتری با چه چیزی پرداخت کرده است.
اگر مشتری کمتر از مبلغ فاکتور بفرستد چه میشود؟
اگر مشتری بهموقع کسری را تکمیل نکند، پرداخت با وضعیت در انتظار (pending) و با مبلغ دریافتی در یادداشت گزارش میشود. پیش از تأیید آن را بررسی کنید.
اگر صفحهٔ پرداخت بدون پرداخت منقضی شود؟
چیزی ثبت نمیشود و مشتری میتواند دوباره پرداخت کند. اگر پول پس از بسته شدن فاکتور برسد، یک رکورد در لاگ ماژولهای WISECP ثبت میشود؛ پول در موجودی SnapEX Pay شماست.
کجا ببینم ماژول چه کرده است؟
در لاگ ماژولهای WISECP: خطاهای API و هر پرداخت ثبتشده آنجا نوشته میشود. کلید API و رمز وبهوک هرگز در لاگ نوشته نمیشوند.
یکپارچه‌سازی‌های دیگر
-
WHMCS
بیلینگ هاستینگ
-
BILLmanager
بیلینگ هاستینگ
-
FOSSBilling
بیلینگ هاستینگ
-
Paymenter
بیلینگ هاستینگ
- Blesta بیلینگ هاستینگ
- RootPanel بیلینگ هاستینگ
-
WooCommerce
فروشگاه‌های آنلاین
-
CS-Cart
فروشگاه‌های آنلاین
- Xboard / V2Board پنل‌های VPN
-
Marzban
پنل‌های VPN
-
3x-ui
پنل‌های VPN
-
Remnawave
پنل‌های VPN
-
ربات VPN تلگرام
پنل‌های VPN
-
n8n
اتوماسیون
آماده دریافت کریپتو هستید؟
حساب فروشنده بسازید، کلید API بگیرید و ماژول را وصل کنید. 1٪ برای هر پرداخت، بدون هزینه ماهانه.