پرداخت کریپتو برای Blesta
روی فاکتورهای Blesta کریپتو دریافت کنید. SnapEX Pay یک درگاه non-merchant است: مشتری SnapEX Pay (Crypto) را انتخاب می‌کند، در صفحه SnapEX Pay با USDT در شبکه‌های TRON، Ethereum، BSC و شبکه‌های دیگر، یا با کوین‌های دیگر با تبدیل به USDT پرداخت می‌کند و پرداخت در Blesta به‌طور خودکار ثبت و روی فاکتورها اعمال میشود.
رایگان. نسخه 1.0.0.
چه کاری انجام می‌دهد
- بدون نیاز به کیف پول یا نود: وجه به موجودی فروشنده SnapEX Pay شما واریز میشود.
- پرداخت با وبهوک امضاشده یا به‌محض بازگشت مشتری به صفحه «پرداخت دریافت شد» ثبت میشود، هر کدام زودتر رخ دهد. در هر دو حالت فاکتور ابتدا دوباره از API در SnapEX Pay خوانده میشود: متن وبهوک به‌تنهایی هیچ چیزی را پرداخت‌شده علامت نمی‌زند و هیچ پرداختی دو بار ثبت نمیشود.
- هر ارزی برای فاکتور: مبالغ غیر USD با نرخ‌هایی که Blesta از قبل نگه می‌دارد به USD تبدیل می‌شوند و تراکنش به ارز فاکتور ثبت میشود.
- پرداخت‌های ناقص هرگز خودکار اعمال نمی‌شوند: به‌صورت یک تراکنش در انتظار (pending) برای بررسی شما ثبت می‌شوند.
- حالت تست: فاکتورهای تست بدون پول واقعی خودبه‌خود تأیید می‌شوند؛ تا وقتی روشن است، فقط کارکنانی که به‌عنوان مشتری وارد شده‌اند دکمه را می‌بینند و از سایر مشتریان خواسته میشود روش پرداخت دیگری انتخاب کنند.
نصب
- محتوای آرشیو را با حفظ مسیر
components/gateways/nonmerchant/snapex_pay/در پوشه اصلی Blesta آپلود کنید. - در پنل ادمین Blesta به Settings → Payment Gateways → Available بروید، SnapEX Pay (Crypto) را پیدا کنید و روی Install بزنید. نصب یک جدول به نام
snapex_pay_invoicesمی‌سازد. - در پنل فروشنده SnapEX Pay یک کلید API با دسترسی‌های
invoices.readوinvoices.writeبسازید و در فیلد API key وارد کنید. - وبهوک (الزامی): در پنل یک وبهوک با آدرس
https://<your Blesta>/callback/gw/<company id>/snapex_pay/اضافه کنید (آدرس دقیق در تنظیمات درگاه نمایش داده میشود) و رمزwhsec_…را در Webhook secret وارد کنید. Blesta برای درگاهها cron ندارد، پس وقتی مشتری به سایت برنمی‌گردد، پرداخت از راه وبهوک میرسد. - اگر فاکتورهای شما به USD نیستند، در Settings → Company → Currencies ارز USD را با نرخ تبدیل اضافه کنید (یا بگذارید Blesta نرخ‌ها را خودکار به‌روز کند). ارزهایی را که درگاه باید برایشان نمایش داده شود تیک بزنید.
- حالت تست را روشن کنید، از پنل ادمین به‌عنوان یک مشتری وارد بخش مشتری شوید، یک فاکتور را در صفحه 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 | بدون تغییر بگذارید. |
سؤالات
چرا وبهوک الزامی است؟
Blesta برای درگاهها cron ندارد. اگر مشتری پرداخت کند و به سایت برنگردد، پرداخت از راه وبهوک امضاشده به Blesta میرسد. اگر مشتری برگردد، پرداخت همان لحظه ثبت میشود و هرگز دو بار ثبت نمیشود.
فاکتورهای من به USD نیستند. کار می‌کند؟
بله. در Settings → Company → Currencies ارز USD را با نرخ تبدیل اضافه کنید. مبالغ با نرخ‌های Blesta تبدیل می‌شوند و تراکنش به ارز فاکتور ثبت میشود.
وقتی فاکتور پرداخت شود در Blesta چه ثبت میشود؟
یک تراکنش تأییدشده (approved) به ارز فاکتور که روی فاکتورهای پرداخت‌شده اعمال میشود. شناسه تراکنش، شناسه فاکتور SnapEX Pay (INV-…) است و مشتری ایمیل معمول Blesta درباره دریافت پرداخت را می‌گیرد.
اگر مشتری کمتر از مبلغ فاکتور بفرستد چه؟
اگر مشتری بهموقع بقیه را نپردازد، یک تراکنش در انتظار با مبلغ دریافتی در پیام آن ثبت میشود و اعمال نمیشود. آن را در تراکنشهای مشتری بررسی کنید.
اگر صفحه پرداخت بدون پرداخت منقضی شود چه؟
چیزی ثبت نمیشود. اگر پول پس از بسته شدن فاکتور برسد، یک ورودی در لاگ درگاه ثبت میشود؛ پول در موجودی SnapEX Pay شما است.
کارهای ماژول را کجا ببینم؟
در Blesta، بخش Tools → Logs → Gateway.
یکپارچه‌سازی‌های دیگر
آماده دریافت کریپتو هستید؟
حساب فروشنده بسازید، کلید API بگیرید و ماژول را وصل کنید. 1٪ برای هر پرداخت، بدون هزینه ماهانه.