ماژول درگاه پرداخت WHMCS؛ چند درگاه و ثبت فیش بانکی

26 آبان 1405

ماژول درگاه پرداخت WHMCS یا Multi Gateway، مدیریت درگاه‌های آنلاین و فیش‌های بانکی را در یک مسیر جمع می‌کند. به‌جای پراکندگی وضعیت پرداخت میان چند ابزار، می‌توانید درگاه‌های قابل پشتیبانی، درخواست‌های کارت به کارت، بررسی حسابدار و گزارش تراکنش‌ها را از پنل ماژول پیگیری کنید.

نسخهٔ ۴ با تمرکز بر ثبت نتیجهٔ پرداخت در WHMCS و ساده‌تر شدن کار مدیر و حسابدار معرفی شده است. در این راهنما، امکانات و مراحل راه‌اندازی را با تصاویر پنل می‌بینید. پیش از استفادهٔ عملیاتی، تنظیمات هر درگاه و ثبت یک پرداخت نمونه را بررسی کنید.

امکانات کلیدی در یک نگاه

  • درگاه‌های پشتیبانی‌شده در یک پنل: بانک‌ها و پرداخت‌یارهای معرفی‌شده در کتابخانهٔ ماژول، از جمله ملت، سامان، پارسیان و زرین‌پال؛ فهرست و سازگاری مورد نیاز را پیش از نصب بررسی کنید.
  • چند درگاه از یک بانک: مثلاً دو ترمینال ملت با نام، لوگو و اولویت جدا
  • ثبت فیش بانکی: کارت به کارت، حواله شبا و حساب به حساب، با آپلود تصویر یا PDF فیش
  • فیش چندپارتی: مشتری می‌تواند مبلغ را در چند واریز (تا ۵ پارت) پرداخت و همه را در یک فیش ثبت کند
  • پنل حسابدار: تایید، رد، رد یک پارت، ویرایش و ثبت فیش برای صورتحساب، با تاریخچه کامل تغییرات
  • تشخیص شماره پیگیری تکراری و هشدار فوری به مدیر
  • صورتحساب رسمی (ارزش افزوده): درگاه رسمی و غیررسمی بر اساس انتخاب مشتری
  • اطلاع‌رسانی خودکار از طریق پیام‌رسان بله و ایمیل، به ازای هر فیش
  • پشتیبانی از Proxy: اتصال به درگاه‌های ایرانی از سرور خارج از ایران
  • داشبورد و گزارش: آمار ۳۰ روز اخیر، جستجوی پیشرفته، شماره کارت، RRN و خروجی CSV
  • شارژ مستقیم حساب (Add Funds) و پرداخت گروهی بدون مرحله اضافه
  • غیرفعال‌سازی خودکار درگاه معیوب و فعال‌سازی دوباره پس از رفع مشکل
  • لاگ کامل عملیات مدیران در Activity Log خود WHMCS
  • رابط کاربری فارسی و راست‌چین، سازگار با موبایل، با فونت وزیرمتن

داشبورد: همه پرداخت‌ها در یک صفحه

داشبورد، آمار ۳۰ روز اخیر، پرداخت‌های موفق، فیش‌های در انتظار و وضعیت درگاه‌ها و Proxyها را کنار هم قرار می‌دهد. جدول تراکنش‌ها برای دنبال کردن پرداخت آنلاین و واریز دستی در یک صفحه در نظر گرفته شده است؛ از فیلتر وضعیت، درگاه و بازهٔ تاریخ برای محدود کردن نتایج استفاده کنید.

برای پیدا کردن تراکنش، می‌توانید از شمارهٔ صورتحساب، شناسهٔ پرداخت، مشخصات مشتری یا شمارهٔ مرجع استفاده کنید. اطلاعات بانکی مانند RRN و Trace، در صورت ارائه از طرف درگاه، به تطبیق پرداخت کمک می‌کنند. شمارهٔ کارت به‌صورت پوشیده نمایش داده می‌شود؛ گزارش را با نتیجهٔ همان تراکنش تطبیق دهید.

داشبورد ماژول درگاه پرداخت WHMCS با آمار و لیست تراکنش‌ها
داشبورد ماژول درگاه پرداخت WHMCS با آمار و لیست تراکنش‌ها

مدیریت درگاه‌ها

در زبانهٔ درگاه‌ها، اتصال‌های مورد نیاز را بسازید؛ امکان تعریف چند اتصال از یک بانک نیز در نظر گرفته شده است. پیش از فعال کردن برای مشتریان، گزینه‌های زیر را برای هر اتصال جداگانه بررسی کنید:

  • نام نمایشی و لوگو: اگر لوگو آپلود نکنید، آیکن پیش‌فرض همان بانک نمایش داده می‌شود
  • اولویت: ترتیب نمایش درگاه‌ها در صفحه پرداخت مشتری
  • نرخ تبدیل: مثلاً اگر واحد پولی WHMCS تومان و واحد درگاه ریال است، عدد ۱۰
  • واحد پولی: هر درگاه فقط به مشتریانی با همان ارز نمایش داده می‌شود
  • رسمی / غیررسمی: برای فروش با و بدون ارزش افزوده
  • وضعیت: فعال، غیرفعال یا «موقتاً غیرفعال» (خودکار)
  • اتصال از طریق Proxy و در صورت نیاز اتصال مستقیم جایگزین
لیست درگاه‌های پرداخت در ماژول Multi Gateway
لیست درگاه‌های پرداخت در ماژول Multi Gateway

با انتخاب بانک، فیلدهای اتصال همان درگاه مانند Merchant ID یا شناسهٔ ترمینال نمایش داده می‌شوند. اطلاعات را از ارائه‌دهندهٔ درگاه بگیرید و تست اتصال را انجام دهید. تست اتصال را با آزمون کامل پرداخت و برگشت مشتری از بانک یکسان در نظر نگیرید.

فرم افزودن درگاه پرداخت جدید در WHMCS
فرم افزودن درگاه پرداخت جدید در WHMCS

برای مدیریت خطاهای پیاپی، می‌توانید آستانهٔ غیرفعال‌سازی موقت را تنظیم کنید. Cron سلامت اتصال را در بازهٔ مستندشدهٔ ماژول بررسی و وضعیت را دوباره ارزیابی می‌کند. پیش از فعال‌سازی مجدد یا تغییر تنظیمات، پیام خطا و علت اختلال را مرور کنید.

اتصالی که سابقهٔ تراکنش موفق دارد، در مسیر حذفِ بدون سابقه قرار نمی‌گیرد؛ برای توقف استفاده، وضعیت آن را غیرفعال کنید. نگهداری شناسهٔ درگاه در سوابق، بررسی پرداخت‌های قدیمی را ساده‌تر می‌کند.

ثبت فیش بانکی: کارت به کارت، شبا و حساب به حساب

در روش ثبت فیش، مشتری شمارهٔ حساب مقصد را می‌بیند و پس از واریز، مبلغ، شمارهٔ پیگیری، تاریخ و تصویر سند را وارد می‌کند. کنترل ساختار فرم به کاهش خطای ورود اطلاعات کمک می‌کند؛ ثبت یا درست بودن شکل شماره، تأیید واریز در حساب بانکی نیست و بررسی حسابدار همچنان لازم است.

  • شماره کارت دقیقاً ۱۶ رقم، شبا با پیشوند IR و ۲۴ رقم، و شماره حساب ۶ تا ۲۶ رقم بررسی می‌شود
  • اعداد فارسی به صورت خودکار تبدیل می‌شوند و فاصله و خط تیره متنی که از اپلیکیشن بانک کپی شده حذف می‌شود
  • اگر مشتری مبلغ را در چند تراکنش واریز کرده باشد، می‌تواند تا ۵ پارت را با فیش جداگانه در یک درخواست ثبت کند
  • فیش‌ها با نام تصادفی و خارج از دسترس عمومی وب ذخیره می‌شوند و نوع فایل از روی محتوا بررسی می‌شود

پنل بررسی فیش‌ها برای حسابدار

پنل حسابدار، فیش‌های در انتظار را همراه مبلغ، شمارهٔ پیگیری، حساب مقصد و ماندهٔ صورتحساب نمایش می‌دهد. شمارندهٔ موارد معوق در منوی ماژول و ویجت مدیریت، به پیدا کردن کارهای باقی‌مانده کمک می‌کند.

صفحه بررسی فیش‌های بانکی در انتظار تایید
صفحه بررسی فیش‌های بانکی در انتظار تایید

در جزئیات فیش، تصویر هر پارت، اطلاعات ثبت‌شده و تاریخچهٔ تغییرات را بررسی کنید. پس از تطبیق با واریز واقعی، عملیات مناسب را انتخاب کنید:

  • تایید کنید: پرداخت با API رسمی WHMCS ثبت می‌شود و فیش فقط پس از ثبت واقعی پرداخت تایید می‌شود. پرداخت تکراری هم ثبت نمی‌شود، حتی با کلیک دوباره یا همزمان.
  • رد کنید: با ذکر دلیل. مشتری خودکار مطلع می‌شود.
  • یک پارت را رد کنید: در فیش‌های چندپارتی، فقط پارت مشکل‌دار رد می‌شود و بقیه پارت‌ها برای تایید باقی می‌مانند.
  • ویرایش کنید: مبلغ، شماره پیگیری، تاریخ و فایل را اصلاح کنید، با ثبت مقدار قبلی و جدید و نام مدیر.
  • برای صورتحساب فیش ثبت کنید: برای مشتری‌ای که فیش را از طریق دیگری فرستاده، با گزینه «ثبت و تایید».
جزئیات فیش بانکی با پارت‌های واریز و دکمه‌های تایید، رد و ویرایش
جزئیات فیش بانکی با پارت‌های واریز و دکمه‌های تایید، رد و ویرایش

اگر شمارهٔ پیگیری با سابقهٔ دیگری تکرار داشته باشد، ماژول برچسب و لینک مورد قبلی را نمایش می‌دهد و هشدار مدیریتی می‌فرستد. این نشانه برای بررسی بیشتر است؛ به‌تنهایی جای تطبیق مبلغ، حساب مقصد و تاریخ واریز را نمی‌گیرد. جستجو در همهٔ فیش‌ها برای بررسی سوابق در دسترس است.

اطلاع‌رسانی خودکار با بله و ایمیل

اطلاع‌رسانی ثبت یا رد فیش از کانال‌های فعال ماژول انجام می‌شود. پیش از ارائهٔ سرویس، اطلاعات گیرنده و تنظیمات هر کانال را با یک پیام نمونه بررسی کنید:

  • پیام‌رسان بله: ارسال پیام همراه با تصویر فیش، به شماره موبایل ثبت‌شده مشتری
  • ایمیل: با قالب‌های ایمیل خود WHMCS که هنگام فعال‌سازی به صورت خودکار ساخته می‌شوند و قابل ویرایش‌اند

برای فیش چندپارتی، اعلان هر واریز با مشخصات همان پارت ساخته می‌شود. پیام ناموفق در صف پیگیری قرار می‌گیرد؛ وضعیت ارسال را مستقل از تأیید مالی فیش بررسی کنید تا اختلال در اعلان با نتیجهٔ پرداخت اشتباه نشود.

تنظیمات اطلاع‌رسانی بله و ایمیل در ماژول درگاه WHMCS
تنظیمات اطلاع‌رسانی بله و ایمیل در ماژول درگاه WHMCS

صورتحساب رسمی و ارزش افزوده

اگر فرایند فروش شما بین درگاه‌های مرتبط با صورتحساب رسمی و سایر درگاه‌ها تفاوت می‌گذارد، فیلد انتخاب مشتری و علامت هر درگاه را مطابق آن تنظیم کنید. این قابلیت مسیر نمایش درگاه را کنترل می‌کند؛ صدور سند مالیاتی و تعیین نرخ مالیات باید در سامانه و تنظیمات مرتبط انجام شود.

تنظیمات صدور صورتحساب رسمی و ارزش افزوده
تنظیمات صدور صورتحساب رسمی و ارزش افزوده

اگر این تفکیک در فرایند فروش شما کاربرد ندارد، گزینهٔ مربوط را فعال نکنید. پس از هر تغییر، نمایش درگاه را برای مشتری با وضعیت‌های مختلف بررسی کنید.

شرح خوانا برای پرداخت‌ها در WHMCS

قالب شرح تراکنش کمک می‌کند در فهرست پرداخت‌های WHMCS اطلاعاتی مانند شمارهٔ فیش، روش واریز، شمارهٔ مرجع و مدیر تأییدکننده را کنار هم ببینید. قالب را متناسب با روش تطبیق حسابداری انتخاب کنید تا شرح‌ها کوتاه و قابل جستجو بمانند.

قالب شرح تراکنش پرداخت در WHMCS
قالب شرح تراکنش پرداخت در WHMCS

اتصال به درگاه‌های ایرانی از سرور خارج (Proxy)

اگر ارائه‌دهندهٔ درگاه، اتصال مستقیم از IP سرور خارج را محدود کرده باشد، Proxy Client می‌تواند مسیر ارتباط سازگار را از یک میزبان ایرانی فراهم کند. ابتدا محدودیت واقعی همان درگاه و شرایط سرویس را بررسی کنید؛ همهٔ اتصال‌ها الزاماً تنظیم یکسانی ندارند.

  • امکان تعریف چند Proxy با اولویت، همراه با بررسی خودکار سلامت آن‌ها
  • ارتباط امن با توکن اختصاصی، محدودیت IP و دامنه‌های مجاز
  • صفحه پایش تراکنش‌های Proxy: پیدا کردن پرداخت‌هایی که در بانک تایید شده‌اند ولی مشتری به سایت برنگشته، و ثبت آن‌ها با یک کلیک
  • استعلام دستی وضعیت پرداخت از بانک
  • یک Proxy Client برای چند سایت WHMCS، با تفکیک کامل تراکنش‌ها
مدیریت Proxy برای اتصال به درگاه‌های بانکی ایران
مدیریت Proxy برای اتصال به درگاه‌های بانکی ایران

Proxy Client محصول جداگانه‌ای است و همراه این ماژول ارائه نمی‌شود. اگر اتصال مستقیم در محیط شما برقرار است، تنها به دلیل محل میزبانی، اضافه کردن Proxy را ضروری فرض نکنید. نیاز آن را بر اساس تست و شرایط درگاه مشخص کنید.

لاگ کامل عملیات

عملیات مدیریتی مانند ثبت، بررسی فیش و تغییر تنظیمات در گزارش‌های WHMCS قابل پیگیری‌اند. از فیلتر مدیر، دسته، متن و تاریخ برای پیدا کردن یک رخداد استفاده کنید. سوابق گزارش را برای تطبیق عملیات نگه دارید و هنگام ارسال گزارش به پشتیبانی، اطلاعات ورود و توکن‌های محرمانه را حذف کنید.

صفحه لاگ عملیات مدیران در ماژول درگاه پرداخت
صفحه لاگ عملیات مدیران در ماژول درگاه پرداخت

امکانات دیگر

  • شارژ مستقیم حساب: در صفحه افزودن اعتبار، درگاه‌های مجاز نمایش داده می‌شوند و مشتری مستقیم به بانک منتقل می‌شود. پرداخت گروهی (Mass Pay) هم همین‌طور کار می‌کند.
  • ثبت پرداخت‌های جاافتاده: اگر مشتری پس از پرداخت به سایت برنگردد، Cron نتیجه را بررسی و پرداخت را ثبت می‌کند.
  • ویجت داشبورد WHMCS: فیش‌های در انتظار بررسی را در صفحه اول مدیریت WHMCS نشان می‌دهد.
  • به‌روزرسانی کتابخانه درگاه‌ها از داخل پنل: پیش از نصب، سازگاری هر درگاه با نسخه PHP سرور شما بررسی و اعلام می‌شود.
  • ارتقای خودکار: با جایگزینی فایل‌ها، دیتابیس از هر نسخه قبلی بدون از دست رفتن داده ارتقا پیدا می‌کند و تنظیمات درگاه‌های کارت به کارت قدیمی منتقل می‌شوند.
  • امنیت: محافظت CSRF برای همه عملیات مدیریتی، رمزنگاری توکن‌ها و بررسی تطبیق مبلغ، صورتحساب و درگاه در تایید پرداخت.

پیش‌نیازها

  • WHMCS نسخه ۸.۰ یا بالاتر
  • PHP نسخه ۸.۰ یا بالاتر، با افزونه‌های curl، openssl، json و mbstring
  • Cron فعال WHMCS
  • برای سرورهای خارج از ایران: یک هاست ایرانی برای Proxy Client (اختیاری)

آموزش نصب و فعال‌سازی

  1. ماژول را از این لینک خریداری کنید. بعد از خرید، از منوی «سرویس‌ها ← لایسنس‌های من» کد لایسنس (به شکل Licenseha_MG_XXXX) و فایل ماژول را دریافت کنید.
  2. فایل zip را در پوشه اصلی WHMCS (کنار پوشه modules) آپلود و از حالت فشرده خارج کنید، سپس فایل zip را پاک کنید.
  3. از مسیر System Settings ← Payment Gateways درگاه Multi Gateway را فعال کنید و نامی برای آن انتخاب کنید. اگر WHMCS شما چند واحد پولی دارد، برای این درگاه واحد پولی تعیین نکنید.
  4. از مسیر System Settings ← Addon Modules ماژول Multi Gateways Portal را فعال کنید، کد لایسنس را وارد کنید و در Access Control دسترسی نقش‌های مدیر موردنظر را بدهید.
  5. از منوی Addons ← Multi Gateways Portal وارد ماژول شوید، درگاه‌ها و حساب‌های بانکی را اضافه کنید و تنظیمات را انجام دهید.
  6. پیشنهاد می‌شود در System Settings ← General Settings ← Ordering گزینه Auto Redirect on Checkout را روی «Automatically take the user to the invoice» قرار دهید.

فعال بودن Addon به‌تنهایی کافی نیست؛ درگاه Multi Gateway را هم در بخش Payment Gateways بررسی کنید. هشدار بالای صفحه، مسیر تنظیمات ناقص را نشان می‌دهد تا پیش از آزمون پرداخت آن را تکمیل کنید.

لایسنس

  • هر لایسنس برای یک سایت (یک دامنه و نصب WHMCS) معتبر است.
  • اگر ارتباط سرور شما با licenseha.com برای مدتی قطع شود، ماژول با آخرین وضعیت معتبر به کار ادامه می‌دهد. برای سرورهای بدون دسترسی هم «کلید آفلاین» از ناحیه کاربری قابل دریافت است.
  • در صورت مشکل لایسنس، پرداخت‌های در جریان و بررسی فیش‌های ثبت‌شده متوقف نمی‌شوند.

پرسش‌های متداول

آیا داده‌های نسخهٔ قبلی حفظ می‌شوند؟

ماژول مسیر ارتقای داده و انتقال تنظیمات قدیمی را دارد. پیش از جایگزینی فایل‌ها از فایل و پایگاه داده پشتیبان بگیرید و نتیجهٔ ارتقا را با چند تراکنش و حساب بانکی نمونه بررسی کنید.

آیا برای هر بانک به ماژول جدا نیاز دارم؟

درگاه‌های پشتیبانی‌شده و ثبت فیش در همین مجموعه مدیریت می‌شوند. پیش از خرید، وجود بانک یا پرداخت‌یار مورد نظر و سازگاری نسخهٔ آن را بررسی کنید.

آیا روی سرور خارج قابل استفاده است؟

روش ثبت فیش به Proxy وابسته نیست. برای پرداخت آنلاین، امکان اتصال مستقیم یا نیاز به Proxy را با شرایط و آزمون همان درگاه تعیین کنید.

اگر مشتری بعد از پرداخت به سایت برنگردد چه می‌شود؟

ماژول امکان پیگیری وضعیت از مسیر Cron و درگاه یا Proxy را دارد. نتیجهٔ استعلام و ثبت پرداخت در WHMCS را کنترل کنید و پیش از ثبت دستی، از تکراری نبودن تراکنش مطمئن شوید.

آموزش مرتبط

برای تفکیک مدیریت پرداخت و صدور سند، راهنمای ماژول فاکتور رسمی و حسابداری WHMCS را نیز ببینید.

لطفا به این محتوا امتیاز دهید