CONTENT
از دریافت افزونه تا اولین سفارش آزمایشی: نصب درگاه پی‌اکسا در ووکامرس و تنظیم کلید، واحد پولی و پیام‌های پرداخت.
اگر فروشگاهتان با ووکامرس ساخته شده و می‌خواهید به مشتری امکان کارت‌به‌کارت با تأیید خودکار بدهید، افزونهٔ پی‌اکسا این کار را بدون نیاز به کدنویسی انجام می‌دهد. در این آموزش از نصب افزونه تا اولین سفارش آزمایشی را مرور می‌کنیم و دربارهٔ تنظیم‌هایی که بیشتر وقت‌ها اشتباه گرفته می‌شود، توضیح می‌دهیم.
افزونه دقیقاً چه کار می‌کند؟
وقتی مشتری درگاه پی‌اکسا را در صفحهٔ پرداخت انتخاب می‌کند، افزونه یک درخواست پرداخت می‌سازد و مشتری را به صفحهٔ پرداخت پی‌اکسا می‌فرستد. پس از بازگشت، افزونه پرداخت را با پی‌اکسا تأیید می‌کند و فقط در صورت موفق بودن، وضعیت سفارش را عوض می‌کند. اگر پی‌اکسا اعلام کند تراکنش قبلاً تأیید شده، سفارش دوباره نهایی نمی‌شود. افزونه از صفحهٔ پرداخت کلاسیک و بلوک‌های ووکامرس پشتیبانی می‌کند.
پیش‌نیازها
- وردپرس نسخهٔ ۶٫۴ یا بالاتر
- ووکامرس نسخهٔ ۸ یا بالاتر
- پی‌اچ‌پی ۷٫۴ یا بالاتر
- حساب پذیرندهٔ فعال و کلید API برای پرداخت واقعی. مراحل در راهنمای فعال‌سازی آمده است.
گام اول: دریافت افزونه
فایل افزونه را از بخش ابزارها دریافت کنید. توجه کنید که فایل را از منبع غیررسمی نگیرید، چون افزونهٔ پرداخت به سفارش‌ها و کلید شما دسترسی دارد.
گام دوم: نصب و فعال‌سازی
- در پیشخوان وردپرس به «افزونه‌ها ← افزودن» بروید و «بارگذاری افزونه» را بزنید.
- فایل zip را انتخاب و نصب کنید. روش دیگر این است که پوشهٔ payexa-gateway را در مسیر /wp-content/plugins/ قرار دهید.
- افزونه را فعال کنید و مطمئن شوید ووکامرس هم فعال است. افزونه بدون ووکامرس کار نمی‌کند.
گام سوم: تنظیمات درگاه
از منوی «ووکامرس» وارد «درگاه پی‌اکسا» شوید. تنظیم‌ها این‌هاست:
- فعال‌سازی درگاه: برای نمایش درگاه در صفحهٔ پرداخت روشن باشد.
- عنوان و توضیحات درگاه: متنی که مشتری هنگام انتخاب روش پرداخت می‌بیند.
- محیط پرداخت: پیش‌فرض «عملیاتی» است. «سندباکس» فقط وقتی فعال می‌شود که آن را صریحاً انتخاب کنید، تا سفارش آزمایشی ناخواسته ثبت نشود.
- کلید API: فقط برای محیط عملیاتی لازم است. در سندباکس نیازی به وارد کردن کلید واقعی نیست. دکمهٔ «تست اتصال» کنار این فیلد وضعیت ارتباط را بررسی می‌کند.
- واحد پولی: سه حالت دارد: خودکار، تومان، ریال. درگاه با ریال کار می‌کند. اگر واحد فروشگاه تومان است، مبلغ پیش از ارسال ضرب در ۱۰ می‌شود. حالت خودکار واحد ووکامرس را می‌خواند و برای بیشتر فروشگاه‌های فارسی درست است.
- متن اعتماد در صفحه پرداخت: پیامی زیر روش پرداخت. اگر نمی‌خواهید، خالی بگذارید.
- متن پرداخت موفق و ناموفق: در پیام موفق می‌توانید از {transaction_id} برای نمایش کد رهگیری و در پیام ناموفق از {fault} برای نمایش دلیل خطا استفاده کنید.
در پایان «ذخیره تنظیمات» را بزنید.
گام چهارم: سفارش آزمایشی
- محیط پرداخت را روی «سندباکس» بگذارید و ذخیره کنید.
- یک محصول ارزان را در فروشگاه سفارش دهید و درگاه پی‌اکسا را انتخاب کنید.
- مراحل پرداخت را در صفحهٔ سندباکس ادامه دهید و بررسی کنید سفارش پس از بازگشت به وضعیت پرداخت‌شده می‌رسد.
- در پایان، محیط را به «عملیاتی» برگردانید و کلید API واقعی را وارد کنید.
می‌توانید مسیر را پیش از نصب هم در سندباکس ببینید.
مشکل‌های رایج
- مبلغ ده برابر یا ده برابر کمتر ارسال می‌شود. واحد پولی افزونه را بررسی کنید. اگر واحد فروشگاه تومان است ولی حالت «ریال» انتخاب شده، مبلغ اشتباه می‌شود.
- درگاه در صفحهٔ پرداخت دیده نمی‌شود. مطمئن شوید «فعال‌سازی درگاه» روشن است و کلید API (در محیط عملیاتی) وارد شده. بدون کلید، افزونه پیام خطا می‌دهد.
- سفارش بعد از پرداخت تکمیل نمی‌شود. لاگ‌های ووکامرس را ببینید؛ افزونه رویدادهای درخواست، پاسخ و خطا را در آن ثبت می‌کند. اگر کلید یا محیط اشتباه باشد، همین‌جا دیده می‌شود.
- مشتری مبلغ را کم یا زیاد واریز کرده است. تأیید خودکار انجام نمی‌شود. مشتری می‌تواند رسید را بفرستد و شما در پنل پی‌اکسا آن را تأیید کنید.
نکات امنیتی
- کلید API را فقط در تنظیمات افزونه وارد کنید و در پوشهٔ قالب یا فایل‌های عمومی قرار ندهید.
- افزونه فقط مبلغ، نشانی بازگشت و یک شناسهٔ سفارش را به پی‌اکسا می‌فرستد. جزئیات در سیاست حریم خصوصی و قوانین آمده است.
- افزونه را همیشه به‌روز نگه دارید.
اگر ربات یا فروش خارج از سایت هم دارید
درگاه را می‌توان همزمان در ربات تلگرام و بله هم استفاده کرد. آموزش ربات تلگرام و آموزش ربات بله را ببینید. و اگر هنوز روش مناسب را انتخاب نکرده‌اید، مقالهٔ مقایسهٔ کارت‌به‌کارت خودکار با درگاه بانکی کمک می‌کند.
برچسب‌ها: #درگاه_پرداخت_ووکامرس #افزونه_وردپرس #فروشگاه_ساز #کارت_به_کارت_خودکار #پی‌اکسا