راهنمای جامع و کاربردی اتصال درگاه پرداخت به ووکامرس

برای اتصال درگاه پرداخت به ووکامرس نیازی به دانش برنامه‌نویسی پیچیده ندارید؛ تمام فرایند در دریافت اطلاعات اتصال از شاپرک یا شرکت‌های پرداخت (PSP) و ثبت آن در افزونه مربوطه خلاصه می‌شود. در این مقاله عملی، تمام مراحل راه‌اندازی، تنظیم واحد پول (تومان/ریال)، تست تراکنش در محیط ایزوله و رفع خطاهای رایج پرداخت را مرور می‌کنیم تا مشتریان شما خریدی بدون قطعی و امن را تجربه کنند.

درگاه پرداخت ووکامرس چیست و چگونه کار می‌کند؟

درگاه پرداخت ووکامرس یک ماژول ارتباطی است که اطلاعات فاکتور خرید را به شبکه پرداخت بانکی (شاپرک) ارسال کرده و پس از انجام عملیات پرداخت توسط کاربر، نتیجه را به فروشگاه شما بازمی‌گرداند. این فرایند از طریق پروتکل‌های امن وب و فراخوانی API انجام می‌شود تا وضعیت سفارش بلافاصله از «در انتظار پرداخت» به «در حال انجام» یا «تکمیل شده» تغییر کند.

وقتی کاربر روی دکمه «پرداخت» کلیک می‌کند، ووکامرس یک درخواست به درگاه می‌فرستد. درگاه پس از تایید شناسه فروشگاه (Merchant Code)، مشتری را به صفحه شاپرک هدایت می‌کند. پس از وارد کردن اطلاعات کارت و تایید، بانک یک کد پیگیری (RefID) به ووکامرس برمی‌گرداند تا سفارش نهایی شود.

مقایسه درگاه پرداخت مستقیم و واسط (کدام مناسب شماست؟)

درگاه‌های مستقیم بلافاصله کاربر را به صفحه شاپرک بانک متصل می‌کنند و هیچ کارمزدی از تراکنش کسر نمی‌کنند، اما دریافت آن‌ها مستلزم داشتن ای‌نماد (نماد اعتماد الکترونیکی) و حساب فعال بانکی است. در مقابل، درگاه‌های واسط (پرداختیارها) ظرف چند ساعت فعال می‌شوند، نیازی به پرونده مالیاتی پیچیده در شروع کار ندارند، اما درصد مشخصی (معمولاً ۱ درصد تا سقف معین) کارمزد دریافت می‌کنند.

پیش‌نیازهای فنی و قانونی دریافت درگاه

قبل از اقدام برای اتصال فنی درگاه، باید بسترهای زیر را روی سایت خود آماده داشته باشید تا درخواست شما توسط PSP یا پرداختیار رد نشود:

• گواهی امنیتی SSL: آدرس سایت باید با https شروع شود. شاپرک اجازه ارسال اطلاعات از پروتکل غیرامن http را نمی‌دهد.
• احراز هویت و کد مالیاتی: ثبت‌نام در سامانه امور مالیاتی و دریافت کد رهگیری مالیاتی برای تمام درگاه‌ها (حتی واسط) الزامی است.
• برگه قوانین و مقررات: وجود صفحه مشخص برای شرایط بازگشت کالا و حریم خصوصی در سایت.
• همخوانی واحد پول: پیکربندی درست واحد پول ایران در ووکامرس تا از خطاهای محاسباتی ۱۰ برابری (تفاوت ریال و تومان) جلوگیری شود.

آموزش گام‌به‌گام اتصال درگاه به ووکامرس

برای نصب و فعال‌سازی درگاه پرداخت روی ووکامرس، مراحل زیر را به ترتیب انجام دهید:

1. ثبت‌نام و دریافت مرچنت کد (Merchant ID):
   
   به سایت پرداختیار (مثل زرین‌پال یا نکست‌پی) یا شرکت PSP (مثل به پرداخت ملت یا سامان کیش) مراجعه کرده، مدارک خود را بارگذاری کنید و کد اختصاصی پذیرنده (Merchant ID یا Terminal ID) را دریافت کنید.
2. نصب افزونه درگاه پرداخت:
   
   از پنل وردپرس به مسیر افزونه‌ها > افزودن بروید. نام درگاه خود (مثلاً «درگاه پرداخت زرین‌پال ووکامرس») را جستجو کرده، آن را نصب و فعال کنید.
3. پیکربندی تنظیمات واحد پول:
   
   به مسیر ووکامرس > پیکربندی > همگانی بروید. واحد پول را روی «تومان» یا «ریال» قرار دهید. دقت کنید واحد پول انتخابی در تنظیمات افزونه درگاه نیز دقیقاً یکسان باشد.
4. ورود کلید اتصال در ووکامرس:
   
   به مسیر ووکامرس > پیکربندی > درگاه‌های پرداخت بروید. روی نام درگاه نصب‌شده (مثلاً زرین‌پال) کلیک کنید. گزینه «فعال‌سازی این روش پرداخت» را علامت بزنید و مرچنت کد دریافت شده را در کادر مربوطه کپی کنید.
5. تنظیم آدرس بازگشت (Callback URL):
   
   اکثر افزونه‌های جدید آدرس بازگشت را به‌صورت خودکار تنظیم می‌کنند. اگر نیاز به وارد کردن دستی بود، آدرسی که افزونه به شما می‌دهد را در پنل درگاه بانکی خود ثبت کنید.
6. تست اولیه تراکنش:
   
   یک محصول تست با مبلغ کم (مثلاً ۱۰۰۰ تومان) تعریف کنید و فرایند خرید را مانند یک مشتری واقعی تا انتهای مرحله پرداخت طی کنید.

۳ نکته حیاتی و تجربه عملی که مانع از دست رفتن فروش می‌شود

طی تجربه پشتیبانی از صدها فروشگاه اینترنتی، این سه مشکل فنی بیشترین آمار انصراف مشتری از خرید را ایجاد می‌کنند:

۱. عدم همخوانی واحد پول (تراکنش‌های ۱۰ برابر زیر قیمت یا فوق‌العاده گران)

یک اشتباه رایج، تنظیم واحد پول ووکامرس روی «تومان» و تنظیم افزونه درگاه روی «ریال» (یا برعکس) است. در این حالت، اگر محصولی ۱۰۰ هزار تومان باشد، موقع انتقال به بانک یا ۱۰ هزار تومان محاسبه می‌شود یا ۱ میلیون تومان! همواره پس از نصب افزونه، بخش واحد پول در هر دو سمت را چک کنید.

۲. خطاهای SSL Handshake و نسخه cURL سرور

درگاه‌های مستقیم بانکی مانند ملت و سامان برای برقراری ارتباط سرور به سرور از کتابخانه cURL و پروتکل TLS 1.2 به بالا استفاده می‌کنند. اگر هاست شما قدیمی باشد یا cURL SSL بسته باشد، ارتباط سایت با بانک در مرحله بازگشت (Callback) قطع شده و سفارش «لغو شده» ثبت می‌شود درحالی‌که پول از حساب مشتری کسر شده است.

۳. عدم استفاده از درگاه پشتیبان (Fallback Gateway)

هیچ درگاه بانکی قطعی صفر درصد ندارد. توصیه می‌شود همزمان دو درگاه (مثلاً یک درگاه مستقیم به‌عنوان درگاه اصلی و یک درگاه واسط به‌عنوان پشتیبان) فعال داشته باشید. اگر هاست یا درگاه اصلی دچار اختلال شد، مشتری بتواند بدون خروج از سایت خرید خود را با درگاه دوم تکمیل کند.

چنانچه برای شخصی‌سازی عملکرد درگاه یا ایجاد منطق شرطی در وردپرس نیاز به افزودن توابع اختصاصی به فایل functions.php دارید، مطالعه کدهای بخش تکه‌کدهای وردپرس راهکارهای آماده‌ای در اختیارتان قرار می‌دهد.

عیب‌یابی سریع و رفع خطاهای رایج درگاه پرداخت

در جدول زیر مشکلات متداول درگاه پرداخت ووکامرس به همراه علت و روش حل سریع آن‌ها آورده شده است:

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