ماژول پرداخت WHMCS
فروشنده هاست و سرور: مشتری فاکتور WHMCS را کارت به کارت میپردازد، فاکتور خودکار تایید میشود و سرویس همان لحظه فعال میشود.
پیش از نصب
- WHMCS نسخه ۸ و PHP نسخه 7.4 یا بالاتر. ماژول هیچ کتابخانه اضافه ای نمیخواهد.
- نشانی WHMCS، در تنظیمات عمومی همان System URL، باید با https باشد. سرور ما خبر پرداخت را به همین نشانی میفرستد.
- واحد پول فاکتورها ریال یا تومان باشد. برای ارز دیگر دکمه پرداخت نشان داده نمیشود.
- دست کم یک کارت فعال برای فروشگاه و اپ فورواردر روی گوشی.
نصب
- ماژول را از پنل بگیرید: صفحه افزونه ها، بخش ماژول WHMCS، دکمه دانلود.
- پوشه modules داخل فایل زیپ را در پوشه اصلی WHMCS بگذارید.
- در مدیریت WHMCS به تنظیمات، بخش Apps & Integrations، دکمه Browse، دسته Payments بروید و «آبان گیت وی» را فعال کنید. در نسخه های قدیمی تر همین کار از Setup، Payments، Payment Gateways انجام میشود.
modules/gateways/abangateway.php
modules/gateways/abangateway/lib.php
modules/gateways/callback/abangateway.phpافزونه ها و اتصالدانلود ماژول WHMCS از پنل
تنظیمات درگاه
| فیلد | از کجا |
|---|---|
| کلید API | پنل، تنظیمات، کلیدهای API. کلید کامل فقط لحظه ساخت نشان داده میشود |
| کلید مخفی وبهوک | پنل، تنظیمات، وبهوک، دکمه «ساخت کلید امضا» |
| واحد مبلغ فاکتورها | «خودکار» برای کد ارز IRR یا IRT؛ وگرنه ریال یا تومان دستی |
| متن دکمه پرداخت | اختیاری؛ پیش فرض «پرداخت کارت به کارت» |
| نشانی API | خالی بگذارید، مگر پشتیبانی نشانی دیگری داده باشد |
چطور کار میکند
مشتری روی فاکتور دکمه پرداخت را میزند. ماژول برای مانده فاکتور، فاکتور آبان گیت وی میسازد و مشتری را به صفحه پرداخت میفرستد. وقتی پیامک بانک از گوشی شما برسد، سرور ما به ماژول خبر میدهد و فاکتور WHMCS پرداخت شده میشود.
هیچ خبری به تنهایی باور نمیشود. چه خبر سرور برسد و چه مشتری از صفحه پرداخت برگردد، ماژول وضعیت را با کلید API شما از سرور ما میپرسد و فقط اگر پرداخت با همان مبلغ ثبت شده باشد، پرداخت را در WHMCS ثبت میکند. هر پرداخت فقط یک بار ثبت میشود، حتی اگر خبر سرور و برگشت مشتری همزمان برسند.
فاکتور WHMCS معمولا چند روز بعد پرداخت میشود، ولی فاکتور ما مهلت دارد. اگر مهلت فاکتور قبلی تمام شده باشد یا مانده فاکتور عوض شده باشد، ماژول خودش فاکتور تازه میسازد و قبلی را میبندد. شماره سفارش ها در پنل شکل whmcs-شماره فاکتور-شماره تلاش دارند.
عیب یابی
گزارش درگاه در WHMCS، بخش Billing و Gateway Log، هر خطا را با کد آن ثبت میکند.
| کد در گزارش | یعنی | چه کنید |
|---|---|---|
| http_401 | کلید API شناخته نشد | کلید کامل را دوباره بسازید و همان لحظه کپی کنید |
| insufficient_fee_wallet | کیف پول کارمزد کافی نیست | کیف پول را از پنل شارژ کنید |
| no_card_registered یا cards_at_ceiling | کارت فعالی برای دریافت نیست | در پنل یک کارت را برای فروشگاه روشن کنید |
| unsafe_callback_url | نشانی WHMCS پذیرفته نشد | System URL را با https و دامنه عمومی بگذارید |
| network | سرور ما در دسترس نبود | چند دقیقه بعد دوباره؛ اگر ماند، با پشتیبانی تماس بگیرید |
اگر پول رسیده ولی فاکتور پرداخت نشده، در پنل بخش وبهوک فهرست تحویل ها را ببینید. اگر خبر نرسیده، نشانی WHMCS از بیرون در دسترس نیست یا فایروال جلویش را گرفته. از همان فهرست میشود خبر را دوباره فرستاد.