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

اگر فروشگاهتان با ووکامرس ساخته شده، اتصال درگاه پرداخت چند دقیقه کار است. این راهنما از دانلود افزونه تا اولین سفارش آزمایشی را پوشش می‌دهد. نیازمندی‌ها: ووکامرس ۶ به بالا و PHP نسخهٔ ۷٫۴ به بالا.

۱. دانلود و نصب

فایل افزونه را از صفحهٔ افزونه‌ها بگیرید. در پیشخوان وردپرس به «افزونه‌ها › افزودن › بارگذاری افزونه» بروید، فایل zip را انتخاب و افزونه را فعال کنید.

۲. فعال کردن درگاه

در «ووکامرس › پیکربندی › پرداخت‌ها»، درگاه «شی‌پی» را روشن کنید و عنوان و توضیحی که مشتری در صفحهٔ پرداخت می‌بیند را بنویسید.

۳. کلید API

در پنل شی‌پی، بخش «API و درگاه‌ها»، یک کلید آزمایشی (sk_test_) بسازید و در تنظیمات افزونه وارد کنید. کلید فقط یک بار نمایش داده می‌شود؛ آن را جایی امن نگه دارید.

۴. واحد پول

در تنظیمات افزونه، واحد مبلغ (تومان یا ریال) را همان واحدی بگذارید که قیمت‌های ووکامرس با آن ثبت شده است. افزونه مبلغ را بر همین اساس به ریال تبدیل و به درگاه می‌فرستد. اشتباه در این تنظیم یعنی مبلغی ده برابر یا یک‌دهم.

۵. سفارش آزمایشی

1. یک محصول به سبد اضافه کنید و با درگاه شی‌پی پرداخت کنید.
2. در بانک آزمایشی نتیجه را انتخاب کنید: موفق، ناموفق یا انصراف.
3. پس از بازگشت، وضعیت سفارش را در ووکامرس ببینید: پرداخت موفق سفارش را به «در حال انجام» (برای محصول مجازی «تکمیل‌شده») می‌برد و کد پیگیری را کنار سفارش ثبت می‌کند؛ پرداخت ناموفق آن را «ناموفق» می‌کند.

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

۶. رفتن به حالت عملیاتی

وقتی درگاه شما در پنل تأیید شد، کلید عملیاتی بسازید و جایگزین کلید آزمایشی کنید. دامنهٔ فروشگاه باید همان دامنهٔ تأییدشده در پنل باشد، وگرنه آدرس بازگشت پذیرفته نمی‌شود.

خطاهای رایج

• مبلغ اشتباه در بانک: واحد مبلغ در تنظیمات افزونه را با واحد پول ووکامرس مقایسه کنید.
• خطای کلید نامعتبر: کلید آزمایشی را با درگاه عملیاتی (یا برعکس) اشتباه نگیرید.
• بازگشت به صفحهٔ خطا: افزونه‌های کش یا امنیتی ممکن است مسیر بازگشت درگاه را مسدود کنند؛ مسیر wc-api را از کش مستثنا کنید.

از درگاه دیگری می‌آیید؟ راهنمای مهاجرت را ببینید. کارمزد هر سفارش را با محاسبه‌گر کارمزد حساب کنید.