درگاه پرداخت WHMCS؛ شاپرکی یا کارت به کارت، و فعال شدن خودکار سرویس

هاست، سرور یا دامنه میفروشید و WHMCS را راه انداخته اید. سؤال بعدی تقریباً همیشه این است که درگاه پرداخت WHMCS را از کجا بیاورید تا فاکتور خودش پرداخت شده شود و سرویس بدون شما فعال شود. جوابش برای فروشنده ایرانی با آموزش های خارجی فرق دارد، چون درگاه هایی که آنجا میبینید برای حساب ایرانی باز نمیشوند و درگاه شاپرکی هم شرط های خودش را دارد.

ما ماژول کارت به کارت WHMCS را مهر ۱۴۰۵ منتشر کردیم و موقع ساختنش به چند تله خوردیم که در هیچ آموزشی ندیده بودیم. اینجا هم راه ها را میگوییم، هم آن تله ها را.

خلاصه ۳۰ ثانیه ای WHMCS خودش پول نمیگیرد. ماژول درگاه پول را میگیرد و به WHMCS خبر میدهد، و WHMCS سرویس را فعال میکند. فروشنده ایرانی سه راه دارد: انتقال بانکی داخلی خود WHMCS که هر پرداختش را باید دستی ثبت کنید، ماژول شاپرکی که اینماد و کد رهگیری مالیاتی میخواهد، و ماژول کارت به کارت که با پیامک بانک فاکتور را میبندد. هر کدام را گرفتید، تنظیم فعال سازی خودکار محصول را هم ببینید.

درگاه پرداخت WHMCS دقیقاً کجای کار است؟

درگاه پرداخت WHMCS یک ماژول است که بین فاکتور و پول مینشیند. مشتری روی فاکتور دکمه پرداخت را میزند، ماژول او را به صفحه پرداخت میفرستد و وقتی پرداخت تأیید شد، آن را روی فاکتور ثبت میکند. از آنجا به بعد کار خود WHMCS است: فاکتور پرداخت شده میشود و سرویس ساخته میشود.

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

WHMCS چیست و پرداخت کجای آن است؟

WHMCS نرم افزار مدیریت مشتری و صورتحساب برای کسب و کارهای هاستینگ است. اسمش کوتاه شده Web Host Manager Complete Solution است و کارش خودکار کردن چرخه فروش است: مشتری سفارش میدهد، فاکتور ساخته میشود، بعد از پرداخت سرویس روی سرور ساخته میشود و نزدیک سررسید، فاکتور تمدید خودش صادر میشود. تیکت پشتیبانی و ثبت دامنه هم در همان پنل است.

برای ساختن سرویس روی سرور، WHMCS ماژول سرور دارد، مثل اتصال به cPanel یا DirectAdmin. برای پول هم ماژول درگاه. پس راه اندازی سایت فروش هاست و دامنه با WHMCS سه تکه جدا میخواهد: خود WHMCS با لایسنسش، ماژول سرور، و درگاه پرداخت. دو تای اول را آموزش های زیادی گفته اند؛ این مقاله درباره سومی است.

WHMCS حساب و کتاب را نگه میدارد. پول و سرور کار ماژول هاست.

فروشنده ایرانی چه درگاهی برای WHMCS دارد؟

سه راه، با سه رفتار متفاوت بعد از پرداخت.

اولی انتقال بانکی است که خود WHMCS دارد. شماره حساب یا کارت را روی فاکتور نشان میدهد و همین. طبق مستندات خود WHMCS درباره Bank Transfer، هر پرداختی که رسید را باید خودتان از بخش Add Payment فاکتور ثبت کنید؛ نه تأیید خودکار دارد، نه حالت آزمایشی. یعنی مشتری نیمه شب پول میزند و سرورش صبح ساخته میشود، وقتی شما بیدار شدید و پرداخت را ثبت کردید.

دومی ماژول شاپرکی است که پرداخت یارها و شرکت های PSP برای WHMCS میدهند. پرداخت روی صفحه بانک انجام میشود و تأییدش خودکار است، ولی شرط های شاپرک سر جایش است: اینماد روی همان دامنه، کد رهگیری مالیاتی، و معمولاً ثبت دامنه سایت در پنل خود درگاه. اگر هنوز اینها را ندارید، درگاه بدون اینماد و درگاه پرداخت بدون کد مالیاتی را ببینید، و برای مقایسه شرکت ها بهترین درگاه پرداخت را.

سومی کارت به کارت خودکار است. مشتری از اپ بانک خودش به کارت شما پول میزند، پیامک واریز روی گوشی شما میرسد و فاکتور بدون دخالت شما بسته میشود. اینماد و کد مالیاتی نمیخواهد، چون پول از شاپرک رد نمیشود و مستقیم روی کارت خودتان مینشیند. چیزی که خیلی ها افزونه کارت به کارت WHMCS صدایش میکنند، در زبان خود WHMCS ماژول درگاه است. روش تطبیق پیامک با فاکتور را در تأیید خودکار کارت به کارت نوشته ایم، و اینکه چرا این یکی را میشود ساخت ولی درگاه شاپرکی را نه، در ساخت درگاه پرداخت.

ماژول کارت به کارت WHMCS چطور فاکتور را خودش پرداخت شده میکند؟

در ماژولی که ما ساختیم ترتیب این است. مشتری روی فاکتور دکمه «پرداخت کارت به کارت» را میزند. ماژول برای مانده همان فاکتور، یک فاکتور در آبان گیت وی میسازد و مشتری را به صفحه پرداخت میفرستد که شماره کارت و مبلغ دقیق را نشان میدهد. مشتری از اپ بانکش انتقال میدهد. پیامک واریز به گوشی شما میرسد، سرور ما آن را با فاکتور تطبیق میدهد و به ماژول خبر میدهد.

نکته اصلی اینجاست: ماژول آن خبر را باور نمیکند. با کلید API خودتان وضعیت فاکتور را از سرور ما میپرسد و فقط اگر پرداخت با همان مبلغ ثبت شده باشد، آن را روی فاکتور WHMCS میگذارد. شماره تراکنش هم شناسه فاکتور آبان گیت وی است، تا یک پرداخت هیچ وقت دو بار ثبت نشود. بعد WHMCS کار خودش را میکند.

ماژول به هیچ خبری به تنهایی اعتماد نمیکند؛ قبل از ثبت، دوباره میپرسد.

نصب و تنظیمش، از جای فایل ها تا کلید API و کلید امضا، در راهنمای ماژول پرداخت WHMCS آمده. شرطش WHMCS نسخه ۸ و PHP نسخه 7.4 یا بالاتر است، و نشانی WHMCS باید https باشد، چون خبر پرداخت به همان نشانی میرسد.

تله هایی که موقع ساختن ماژول دیدیم

کد ارز میگوید ریال، قیمت ها تومان است

WHMCS مبلغ فاکتور را با ارزی نگه میدارد که خودتان تعریف کرده اید، و فروشنده های ایرانی کد این ارز را هر جور نوشته اند: IRR، IRT، TMN یا حتی خود کلمه «تومان». ماژول ما این کدها را میشناسد و مبلغ تومانی را ده برابر میکند تا به ریال برسد. ولی اگر کد ارز IRR باشد و قیمت ها را تومان وارد کرده باشید، هیچ ماژولی نمیتواند بفهمد؛ مشتری یک دهم مبلغ را میپردازد. برای همین یک تنظیم دستی گذاشتیم که واحد را خودتان انتخاب کنید. یه نکته ریز: قبل از اولین فروش، یک فاکتور کوچک بسازید و مبلغ صفحه پرداخت را با فاکتور بسنجید.

فاکتور WHMCS صبر میکند، صفحه پرداخت نه

فاکتور تمدید WHMCS ممکن است چند روز باز بماند، ولی فاکتوری که برای پرداخت کارت به کارت ساخته میشود مهلت دارد، چون مبلغ یکتایش فقط تا مدتی برای همان مشتری نگه داشته میشود. اگر مشتری امروز صفحه پرداخت را باز کند و پس فردا برگردد، آن صفحه دیگر زنده نیست. از روز اول تصمیم گرفتیم ماژول در این حالت خودش یک تلاش تازه بسازد و قبلی را ببندد. اگر مانده فاکتور عوض شده باشد هم همین کار را میکند. در پنل، شماره این سفارش ها شکل whmcs-شماره فاکتور-شماره تلاش دارد.

برگشت مشتری مدرک پرداخت نیست

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

دو خبر در یک لحظه

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

مبلغ بزرگ تر از سقف کارت

تمدید سالانه یا سرور اختصاصی ممکن است از سقف کارت به کارت بیشتر شود، که از خرداد ۱۴۰۵ روزانه ۱۵ میلیون تومان برای هر کارت است. آن وقت صفحه پرداخت مبلغ را چند تکه میکند و ماژول فاکتوری را که بخشی از آن پرداخت شده رها نمیکند؛ صبر میکند تا آخرین تکه هم برسد. اگر شبای کارت را در پنل وارد کرده باشید، مشتری میتواند به جای چند انتقال، یک انتقال پل بزند.

کدام درگاه پرداخت WHMCS به کار شما میآید؟

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

	انتقال بانکی داخلی	ماژول شاپرکی	ماژول کارت به کارت
ثبت پرداخت	دستی، از Add Payment	خودکار	خودکار، با پیامک بانک
فعال شدن سرویس	بعد از ثبت دستی شما	بعد از پرداخت	بعد از تطبیق پیامک
مدارک	هیچ	اینماد و کد رهگیری مالیاتی	هیچ؛ کارت و گوشی خودتان
پول کجا مینشیند	حساب شما	با تسویه شاپرکی	مستقیم روی کارت شما
حالت آزمایشی	ندارد	بسته به شرکت	دارد، با کلید ag_test_
محدودیت اصلی	وقت شما	مدارک و کارمزد	سقف روزانه کارت

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

سؤالات متداول

درگاه پرداخت WHMCS بدون اینماد ممکن است؟

با ماژول شاپرکی معمولاً نه، چون بیشتر شرکت ها برای درگاه اینترنتی روی دامنه اینماد میخواهند. با کارت به کارت بله، چون پول به کارت خودتان میرود و از شاپرک رد نمیشود. انتقال بانکی داخلی WHMCS هم اینماد نمیخواهد، ولی هر پرداختش دستی است.

ماژول کارت به کارت WHMCS رایگان است؟

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

ماژول درگاه WHMCS را چطور نصب کنم؟

پوشه modules را از فایل زیپ در پوشه اصلی WHMCS بگذارید، در Apps & Integrations و دسته Payments آن را فعال کنید، و کلید API و کلید امضا را از پنل بچسبانید. واحد مبلغ را اگر کد ارزتان IRR یا IRT نیست، دستی انتخاب کنید. هر خطایی در Gateway Log با کد خودش ثبت میشود.

با کدام نسخه WHMCS و PHP کار میکند؟

WHMCS نسخه ۸ و بالاتر، با PHP نسخه 7.4 یا بالاتر، بدون هیچ کتابخانه اضافه. ماژول تازه منتشر شده و روی PHP 7.4 و 8.3 آزمایش شده است. اگر در نصب به خطایی خوردید، متن آن را از Gateway Log برای پشتیبانی بفرستید.

پرداخت تأیید شد ولی سرویس فعال نشد؛ چرا؟

معمولاً به خاطر تنظیم خود محصول است، نه درگاه. در WHMCS هر محصول در بخش Module Settings چهار گزینه برای ساخت خودکار سرویس دارد: بلافاصله بعد از ثبت سفارش، بعد از اولین پرداخت، بعد از تأیید دستی سفارش، یا هیچ وقت. اگر یکی از دو گزینه آخر انتخاب شده باشد، فاکتور پرداخت میشود و سرویس منتظر شما میماند. برای فروش خودکار «بعد از اولین پرداخت» را بگذارید و ماژول سرور را هم چک کنید.

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