فروشگاه ووکامرسی‌تان آماده است، محصول‌ها را گذاشته‌اید و حمل‌ونقل را هم تنظیم کرده‌اید؛ اما تا وقتی مشتری نتواند همان‌جا با کارت بانکی‌اش پول بدهد، فروش واقعی شروع نمی‌شود. درگاه پرداخت آخرین و حساس‌ترین قطعهٔ فروشگاه اینترنتی است؛ اگر درست تنظیم نشود، یا پول مشتری کم می‌شود و سفارش ثبت نمی‌شود، یا مبلغ ده برابر اشتباه حساب می‌شود.
در این آموزش قدم‌به‌قدم، اتصال درگاه زرین‌پال به ووکامرس را از گرفتن مرچنت کد تا تست در حالت آزمایشی (سندباکس) جلو می‌رویم و رایج‌ترین خطاها را با راه‌حلشان توضیح می‌دهیم. اگر هنوز فروشگاه را راه نینداخته‌اید، اول آموزش نصب و راه‌اندازی ووکامرس را ببینید.
آخرین به‌روزرسانی: ۱۴ آبان ۱۴۰۵ — اطلاعات افزونه از صفحهٔ رسمی آن در مخزن وردپرس (نسخهٔ ۵٫۱٫۱) و مستندات API نسخهٔ ۴ زرین‌پال در ۱۴ آبان ۱۴۰۵ بررسی شده است.
⚡ پاسخ کوتاه
برای اتصال زرین‌پال به ووکامرس: ۱) در زرین‌پال ثبت‌نام کنید و احراز هویت و شماره شبا را کامل کنید تا سطح حسابتان نقره‌ای شود؛ ۲) برای سایتتان (که باید نماد اعتماد الکترونیکی (اینماد) داشته باشد) درخواست درگاه بدهید تا مرچنت کد ۳۶ کاراکتری بگیرید؛ ۳) افزونهٔ رسمی «ZarinPal for WooCommerce» را از مخزن وردپرس نصب کنید؛ ۴) در ووکامرس ← پیکربندی ← پرداخت‌ها مرچنت کد را وارد کنید و واحد پول فروشگاه را با واحد درگاه (تومان یا ریال) یکی کنید؛ ۵) قبل از فعال کردن نهایی، یک سفارش آزمایشی در حالت سندباکس بزنید.
📑 فهرست مطالب
وقتی مشتری در فروشگاه شما دکمهٔ «ثبت سفارش» را می‌زند، ووکامرس سفارش را با وضعیت «در انتظار پرداخت» می‌سازد و از درگاه یک شناسهٔ تراکنش می‌گیرد. بعد مشتری به صفحهٔ پرداخت درگاه (که روی شبکهٔ شاپرک کار می‌کند) می‌رود، اطلاعات کارت را وارد می‌کند و پس از پرداخت به نشانی بازگشت سایت شما برمی‌گردد. در این لحظه سایت باید تراکنش را از درگاه تأیید (Verify) کند؛ فقط بعد از تأیید است که سفارش «در حال انجام» می‌شود و پول به حساب شما می‌آید.
در مستندات زرین‌پال این سه قدم با نام‌های درخواست پرداخت (Request)، هدایت کاربر به صفحهٔ پرداخت (StartPay) و تأیید پرداخت (Verify) آمده است. خوشبختانه با افزونهٔ آماده لازم نیست هیچ‌کدام را خودتان کدنویسی کنید، اما دانستن این مسیر کمک می‌کند خطاها را بفهمید. مثلاً اگر مشتری پس از پرداخت صفحه را ببندد و به سایت برنگردد، مرحلهٔ تأیید انجام نمی‌شود و سفارش در وضعیت «در انتظار پرداخت» می‌ماند.
در ایران دو راه کلی برای پرداخت آنلاین دارید: درگاه مستقیم بانکی که از یک شرکت پرداخت وابسته به بانک می‌گیرید و پول مستقیم به حساب شما می‌رود، و درگاه واسط (پرداخت‌یار) مثل زرین‌پال که خودش با شبکهٔ شاپرک کار می‌کند و پول را طبق برنامهٔ تسویه به حساب شما می‌ریزد.
| ویژگی | درگاه واسط (مثل زرین‌پال) | درگاه مستقیم بانکی |
|---|---|---|
| مدارک و شرایط | ساده‌تر؛ ثبت‌نام آنلاین، اینماد و احراز هویت | معمولاً مدارک بیشتر و مراجعه یا قرارداد با بانک |
| سرعت راه‌اندازی | سریع‌تر | کندتر |
| تسویه | طبق برنامهٔ تسویهٔ پرداخت‌یار | مستقیم به حساب متصل به درگاه |
| افزونهٔ ووکامرس | افزونهٔ رسمی و به‌روز | بسته به بانک؛ گاهی افزونهٔ شخص ثالث |
| امکانات جانبی | پنل گزارش، بازگشت وجه و استعلام تراکنش | بسته به شرکت ارائه‌دهنده |
برای بیشتر فروشگاه‌های کوچک و متوسط، درگاه واسط شروع ساده‌تری است و بعدها اگر حجم فروش بالا رفت می‌توانید درگاه مستقیم هم اضافه کنید. ووکامرس اجازه می‌دهد چند روش پرداخت را هم‌زمان فعال کنید. در ادامه زرین‌پال را مثال زده‌ایم، چون افزونهٔ رسمی‌اش طبق مخزن وردپرس بیش از ۶۰ هزار نصب فعال دارد؛ اما منطق کار برای بیشتر درگاه‌ها یکسان است.
مرچنت کد (Merchant ID) یک شناسهٔ ۳۶ کاراکتری است که درگاه شما را مشخص می‌کند. طبق راهنمای زرین‌پال، این مراحل را باید پشت سر بگذارید:
دامنه‌ای که در درخواست درگاه ثبت می‌کنید باید دقیقاً همان دامنهٔ فروشگاه باشد. اگر سایت با www باز می‌شود و در زرین‌پال بدون www ثبت شده (یا برعکس)، ممکن است با خطای «دامنهٔ کال‌بک با دامنهٔ ثبت‌شده هم‌خوانی ندارد» روبه‌رو شوید.
دربارهٔ هزینه هم بدانید: طبق راهنمای زرین‌پال برای سال ۱۴۰۵، کارمزد ماه اول فقط کارمزد شاپرک است و پس از آن کارمزد استاندارد ۰٫۵ درصد هر تراکنش با سقف ۱۶ هزار تومان به‌علاوهٔ ۵۰۰ تومان ثابت است. این ارقام ممکن است تغییر کند، پس پیش از قرارداد صفحهٔ تعرفه را دوباره ببینید.
افزونهٔ رسمی با نام «افزونه پرداخت امن زرین‌پال برای ووکامرس (ZarinPal for WooCommerce)» در مخزن وردپرس است. نسخهٔ فعلی آن ۵٫۱٫۱ است، به وردپرس ۵٫۸ یا جدیدتر و PHP 7.0 یا بالاتر نیاز دارد و تا وردپرس ۷٫۰٫۸ تست شده است. قبل از نصب هر افزونه‌ای روی فروشگاه فعال، یک نسخهٔ پشتیبان بگیرید؛ روشش را در آموزش بکاپ‌گیری از وردپرس گفته‌ایم.
در پیشخوان وردپرس به «افزونه‌ها ← افزودن» بروید، عبارت ZarinPal را جست‌وجو کنید و افزونهٔ رسمی زرین‌پال را نصب و فعال کنید. اگر دسترسی به مخزن ندارید، فایل افزونه را از صفحهٔ آن در وردپرس دانلود کنید و از «بارگذاری افزونه» نصبش کنید.
به ووکامرس ← پیکربندی ← پرداخت‌ها بروید. روش پرداخت زرین‌پال را باز کنید، آن را فعال کنید، مرچنت کد را بچسبانید و عنوان و توضیحی که مشتری در صفحهٔ تسویه حساب می‌بیند را بنویسید؛ مثلاً «پرداخت امن با همهٔ کارت‌های عضو شتاب».
مهم‌ترین تنظیم همین است. این افزونه واحدهای ریال، تومان، هزار ریال و هزار تومان را به ووکامرس اضافه می‌کند. در ووکامرس ← پیکربندی ← عمومی واحد پول فروشگاه را مشخص کنید و مطمئن شوید قیمت‌ها با همان واحد وارد شده‌اند. اگر فروشگاه به تومان باشد ولی مبلغ به‌عنوان ریال به درگاه برود، مشتری یک‌دهم مبلغ را می‌پردازد؛ برعکسش هم ده برابر از مشتری پول می‌خواهد. API زرین‌پال هم هر دو واحد ریال (IRR) و تومان (IRT) را می‌شناسد.
بعد از پرداخت موفق، خوب است هم شما و هم مشتری فوراً خبردار شوید. روش‌های اطلاع‌رسانی با ایمیل، پیامک و پیام‌رسان را در اطلاع‌رسانی سفارش در ووکامرس آورده‌ایم؛ افزونهٔ بلینو هم اعلان سفارش‌ها را در پیام‌رسان بله برایتان می‌فرستد.
قبل از اینکه درگاه را برای مشتری واقعی باز کنید، یک خرید آزمایشی انجام دهید. افزونهٔ زرین‌پال حالت سندباکس (آزمایشی) دارد که در آن پولی جابه‌جا نمی‌شود. طبق مستندات زرین‌پال، در محیط آزمایشی به‌جای نشانی payment.zarinpal.com از sandbox.zarinpal.com استفاده می‌شود و شناسهٔ تراکنش‌ها با حرف S شروع می‌شود.
این تست را کنار تست هزینهٔ ارسال و کد تخفیف انجام دهید تا کل مسیر خرید یک‌جا امتحان شود؛ چک‌لیست تست سفارش را در تنظیمات حمل‌ونقل ووکامرس و روش ساخت کوپن را در ساخت کد تخفیف در ووکامرس ببینید.
وقتی پرداخت انجام نمی‌شود، زرین‌پال یک کد خطا برمی‌گرداند. افزونه معمولاً این کد را در یادداشت سفارش یا پیام خطا نشان می‌دهد. پرتکرارترین‌ها طبق مستندات رسمی این‌ها هستند:
| کد | معنی | راه‌حل |
|---|---|---|
| -9 | خطای اعتبارسنجی (مثلاً مرچنت کد یا نشانی بازگشت ارسال نشده، توضیح خالی یا بیش از ۵۰۰ کاراکتر، مبلغ خارج از محدوده) | مرچنت کد و واحد پول را دوباره بررسی کنید و افزونه را به‌روز کنید |
| -10 | آی‌پی یا مرچنت کد پذیرنده صحیح نیست | مرچنت کد را بدون فاصلهٔ اضافه دوباره کپی کنید |
| -11 | مرچنت کد فعال نیست | وضعیت درگاه را در پنل زرین‌پال ببینید یا با پشتیبانی تماس بگیرید |
| -14 | دامنهٔ نشانی بازگشت با دامنهٔ ثبت‌شده هم‌خوانی ندارد | دامنهٔ ثبت‌شده در زرین‌پال را با دامنهٔ واقعی سایت (با یا بدون www) یکی کنید |
| -16 | سطح تأیید پذیرنده پایین‌تر از نقره‌ای است | احراز هویت را کامل کنید |
| -41 | مبلغ بیش از سقف مجاز (۱۰۰ میلیون تومان) | سفارش را چند بخش کنید یا با درگاه هماهنگ کنید |
| -50 | مبلغ پرداخت‌شده با مبلغ تأیید هم‌خوانی ندارد | معمولاً مشکل واحد پول؛ تومان و ریال را یکی کنید |
| -51 | پرداخت ناموفق بوده است | مشتری پرداخت را لغو کرده یا کارت مشکل داشته؛ اگر پولی کسر شده طبق قوانین شاپرک برمی‌گردد |
| ۱۰۱ | تراکنش قبلاً تأیید شده است | خطا نیست؛ یعنی سفارش پیش‌تر تأیید شده |
این رایج‌ترین شکایت مشتری‌هاست. معمولاً مشتری بعد از پرداخت صفحه را بسته، اینترنتش قطع شده یا افزونهٔ امنیتی یا کش جلوی بازگشت به سایت را گرفته است. اول با شمارهٔ سفارش یا کد رهگیری در پنل زرین‌پال ببینید تراکنش موفق بوده یا نه. اگر پرداخت ناموفق بوده و پولی کسر شده، طبق قوانین شاپرک به حساب مشتری برمی‌گردد. اگر موفق بوده ولی تأیید نشده، با امکان استعلام تراکنش در افزونه وضعیت را درست کنید.
ووکامرس در نسخه‌های جدید از روش ذخیره‌سازی سفارش با کارایی بالا (HPOS) استفاده می‌کند. سازگاری افزونهٔ زرین‌پال با HPOS در نسخهٔ ۵٫۰٫۱۶ درست شده است و نسخه‌های ۵٫۱٫۰ و ۵٫۱٫۱ هم وصله‌های امنیتی داشته‌اند. پس اگر خطای عجیبی می‌بینید، اول افزونه را به آخرین نسخه برسانید. بعضی کاربران در نظرهای مخزن وردپرس از ناسازگاری با گزینه‌های کش ووکامرس هم گفته‌اند؛ اگر مشکل ادامه داشت، افزونه‌های کش را موقتاً غیرفعال کنید و دوباره تست بگیرید.
اگر تعداد محصول‌هایتان زیاد است و هنوز کاتالوگ را کامل نکرده‌اید، روش درون‌ریزی گروهی محصولات در ووکامرس کمک‌تان می‌کند. اگر هم ترجیح می‌دهید راه‌اندازی فروشگاه، درگاه و تنظیم‌ها را به یک تیم بسپارید، خدمات طراحی و توسعهٔ سایت رادینو را ببینید.
مرچنت کد شناسهٔ ۳۶ کاراکتری درگاه شماست که پس از تأیید درخواست درگاه، در پنل زرین‌پال نمایش داده می‌شود و باید در تنظیمات افزونه وارد شود.
طبق راهنمای زرین‌پال و قوانین شاپرک، برای گرفتن درگاه پرداخت اینترنتی داشتن نماد اعتماد الکترونیکی (اینماد) لازم است.
واحد پول فروشگاه با واحدی که به درگاه فرستاده می‌شود یکی نیست. در تنظیمات عمومی ووکامرس واحد را تومان یا ریال بگذارید و قیمت‌ها را با همان واحد وارد کنید.
بله. ووکامرس اجازه می‌دهد چند روش پرداخت را فعال کنید و مشتری در صفحهٔ تسویه حساب یکی را انتخاب کند. داشتن یک درگاه پشتیبان برای زمان قطعی هم ایدهٔ خوبی است.
طبق راهنمای زرین‌پال برای ۱۴۰۵، کارمزد استاندارد ۰٫۵ درصد هر تراکنش با سقف ۱۶ هزار تومان به‌علاوهٔ ۵۰۰ تومان ثابت است و ماه اول فقط کارمزد شاپرک گرفته می‌شود. پیش از قرارداد تعرفهٔ به‌روز را ببینید.
همه منابع در تاریخ ۱۴ آبان ۱۴۰۵ بررسی شده‌اند.
فروشگاه ووکامرسی راه انداختهاید، محصول‌ها را با عکس و قیمت گذاشته‌اید، اما از گوگل تقریباً هیچ بازدیدی نمیآید. این وضعیت …
هک شدن سایت، یک به‌روزرسانی ناموفق، حذف اشتباهی یک پوشه یا مشکل سرور هاست؛ هر کدام از این‌ها میتواند در …
اگر سایت وردپرسی شما در PageSpeed Insights نمرهٔ نارنجی یا قرمز می‌گیرد، تنها نیستید. خیلی از سایتها با یک قالب …
هزینهٔ ارسال یکی از اولین چیزهایی است که مشتری در صفحهٔ پرداخت می‌بیند و اگر غیرمنطقی یا مبهم باشد، بهراحتی …
نظرات 0
برای ارسال نظر وارد حساب کاربری شوید.
هنوز نظری ثبت نشده؛ اولین نفر باشید.