با این افزونه فروشگاه ووکامرسی خود را به درگاه پرداخت آنلاین پی‌پینگ متصل کنید. مشتری پس از پرداخت به‌صورت خودکار به فروشگاه بازمی‌گردد و وضعیت سفارش او بر اساس نتیجه پرداخت به‌روزرسانی می‌شود.

ویژگی‌های افزونه:

• اتصال مستقیم به درگاه پی‌پینگ و پرداخت با کارت‌های عضو شتاب
• پشتیبانی از واحدهای پول تومان، ریال، هزار ریال و هزار تومان
• نمایش شماره کارت پرداخت‌کننده در صفحه سفارش، در صورت ارسال از سمت بانک
• بخش اختصاصی «داده‌های درگاه پی‌پینگ» در صفحه سفارش همراه با تایم‌لاین رویدادهای پرداخت
• دکمه «استعلام مجدد پرداخت» برای تکمیل سفارش‌هایی که پرداخت آن‌ها انجام شده اما نتیجه آن به فروشگاه نرسیده است
• سازگار با صفحه تسویه حساب بلوکی و قابلیت HPOS ووکامرس

هوک‌ها برای توسعه‌دهندگان

رفتار درگاه با هوک‌های زیر قابل تغییر است و پس از پرداخت موفق، هوک‌های استاندارد ووکامرس (مانند woocommerce_payment_complete) نیز به شکل معمول اجرا می‌شوند.

اکشن‌ها:

• woo_payping_Payment_Success — پس از تایید موفق پرداخت. پارامترها: $order_id, $transaction_id
• woo_payping_Payment_Failed — پس از تایید ناموفق پرداخت. پارامترها: $order_id, $transaction_id, $message
• woo_payping_Payment_Duplicate — هنگامی که پرداخت قبلا تایید شده باشد. پارامترها: $order_id, $transaction_id
• woo_payping_Payment_Cancelled — هنگام انصراف کاربر در صفحه بانک. پارامترها: $order_id
• woo_payping_Send_to_Gateway_Failed — هنگام خطا در ارسال سفارش به درگاه. پارامترها: $order_id, $message
• woo_payping_Admin_Reverified — پس از تایید پرداخت با «استعلام مجدد» در صفحه سفارش. پارامترها: $order_id, $transaction_id

فیلترها:

• WC_payping_Gateway_Payment_api_url — آدرس API ساخت پرداخت
• WC_payping_Gateway_Payment_api_args — آرگومان‌های کامل درخواست ساخت پرداخت (شامل بدنه درخواست)
• WC_payping_Gateway_Payment_verify_api_url — آدرس API تایید پرداخت
• WC_payping_return_refid — کد پیگیری بازگشتی از درگاه
• WC_payping_Currency — واحد پول مورد استفاده در محاسبه مبلغ
• WC_payping_Description، WC_payping_Mobile، WC_payping_Email، WC_payping_Paymenter — اطلاعات پرداخت‌کننده ارسالی به درگاه
• woocommerce_order_amount_total_payping_gateway و woocommerce_order_amount_total_IRANIAN_gateways_before_check_currency، ..._after_check_currency، ..._irt — تغییر مبلغ نهایی پرداخت
• woo_payping_logo — آدرس لوگوی درگاه
• woo_payping_order_panel_rows — ردیف‌های نمایش داده شده در بخش «داده‌های درگاه پی‌پینگ» در صفحه سفارش
• WC_payping_Config — فیلدهای تنظیمات درگاه

Third-Party Services

This plugin leverages the following third-party services:

1. https://api.payping.ir: This plugin adds online payment functionality to the Woocommerce plugin, allowing us to process payments and check payment statuses through https://api.payping.ir.

Privacy Policy

This plugin follows strict privacy guidelines. When using the api.payping.ir service, user data is securely transmitted and stored following industry best practices.

1. پوشه ‘woo-payping-gateway’ را در مسیر ‘/wp-content/plugins/’ آپلود کنید
2. افزونه را از طریق منوی ‘افزونه ها’ در وردپرس فعال کنید
3. تنظیمات افزونه را می توانید از طریق قسمت تنظیمات ووکامرس / پیکربندی/ درگاه های پرداخت انجام دهید

1. 

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

2. 

   درگاه پی‌پینگ در فهرست روش‌های پرداخت ووکامرس پس از فعال‌سازی

توکن درگاه پی‌پینگ را از کجا دریافت کنم؟

پس از ثبت‌نام در پی‌پینگ، از داشبورد شخصی به بخش «درگاه پرداخت» بروید و با گزینه «ایجاد» یک توکن بسازید. توکن دریافتی را در فیلد توکن تنظیمات افزونه وارد کنید. هنگام ساخت توکن به تاریخ انقضا، آدرس وب‌سایت و دسترسی‌های فعال شده دقت کنید.

پیش‌نیاز نصب افزونه چیست؟

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

تنظیمات درگاه پی‌پینگ کجاست؟

از پیشخوان وردپرس به مسیر ووکامرس ← پیکربندی ← درگاه‌های پرداخت و سپس پی‌پینگ بروید و توکن و سایر تنظیمات درگاه را در همین صفحه وارد کنید.

هنگام مواجهه با خطای 401 در اتصال به درگاه چه باید کرد؟

این خطا معمولا به دلیل منقضی شدن توکن یا عدم تطابق آدرس وب‌سایت و دسترسی‌های توکن با سایت شما رخ می‌دهد. توکن را در پنل پی‌پینگ ویرایش و «تعویض توکن» را انجام دهید، سپس توکن جدید را در تنظیمات درگاه جایگزین کنید.

چه واحد پول‌هایی پشتیبانی می‌شود؟

ریال، تومان، هزار ریال و هزار تومان پشتیبانی می‌شوند. مبلغ سفارش در زمان ارسال به درگاه بر اساس واحد پول فروشگاه به تومان تبدیل می‌شود.

چرا سفارش بلافاصله پس از پرداخت «تکمیل شده» می‌شود؟

وضعیت سفارش را ووکامرس تعیین می‌کند. اگر تمام محصولات سفارش مجازی و قابل دانلود باشند، سفارش بلافاصله «تکمیل شده» و در غیر این صورت «در حال انجام» می‌شود.

آیا صفحه تسویه حساب بلوکی ووکامرس پشتیبانی می‌شود؟

بله. درگاه پی‌پینگ به صورت خودکار در صفحه تسویه حساب بلوکی نیز نمایش داده می‌شود.

4.7.0

افزودن دکمه «استعلام مجدد پرداخت» در صفحه سفارش برای تکمیل سفارش‌هایی که پرداخت آن‌ها در درگاه انجام شده اما نتیجه آن به فروشگاه نرسیده است
افزودن دکمه کپی برای کد پرداخت، شماره تراکنش و شناسه پیگیری (Trace ID) در بخش داده‌های درگاه
نمایش برچسب نوع و رنگ رویدادها در تایم‌لاین پرداخت و بهبود قالب‌بندی شماره کارت
حفظ کد پیگیری درگاه روی سفارش برای امکان استعلام مجدد پس از خطای موقت در تایید
جلوگیری از تایید هم‌زمان یک پرداخت (بازگشت هم‌زمان از دو تب باز) با قفل موقت
پشتیبانی از پاسخ JSON خام در بازگشت از درگاه علاوه بر پارامتر data
ماسک شدن فیلد توکن در صفحه تنظیمات درگاه
رفع تداخل ثبت واحد پول ریال/تومان با سایر افزونه‌ها
جداسازی لایه ارتباط با API پی‌پینگ در کلاس مستقل برای پایداری و توسعه پذیری بیشتر

4.6.5

بهبود نمایش پیام خطاهای درگاه پی‌پینگ و نمایش دلیل خطا به جای خروجی خام
افزودن بخش اختصاصی «داده‌های درگاه پی‌پینگ» در صفحه سفارش همراه با تایم‌لاین رویدادهای پرداخت
انتقال اطلاعات پرداخت پی‌پینگ از یادداشت‌های سفارش به بخش اختصاصی درگاه
نمایش شناسه پیگیری (Trace ID) خطاها برای بررسی آسان‌تر با پشتیبانی پی‌پینگ

4.6.4

بهبود فرایند پرداخت و حذف صفحه میانی قبل از هدایت به درگاه
استفاده مجدد از کد پرداخت قبلی و ساخت پرداخت جدید در صورت تغییر مبلغ سفارش
بهبود بررسی‌های تایید پرداخت و تطبیق مبلغ و کد پرداخت
رفع مشکل خواندن تنظیمات درگاه در تسویه حساب بلوکی
افزودن هوک‌های رویداد پرداخت برای توسعه‌دهندگان
پاک‌سازی خودکار تنظیمات درگاه هنگام حذف کامل افزونه
بازنویسی راهنمای افزونه، افزودن پرسش‌های متداول و بخش تصاویر

4.6.3

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

4.6.1

بهبود عملکرد افزونه

4.6.0

بهبود عملکرد افزونه و رفع مشکلات گزارش شده

4.5.1

تغییر در ثبت توضیحات سفارش

4.5.0

بروزرسانی وب سرویس پی پینگ به نسخه جدید.

4.4.0

سازگاری با نسخه جدید ووکامرس و ویرایشگر بلوک.

4.3.0

بهبود عملکرد نمایش خطا ها در صفحه تسویه حساب.
حذف حالت اشکال زدایی(تغییر فرایند اشکال زدایی).
سازگاری با php 8.x
سازگاری با نسخه جدید وکامرس و وردپرس.

4.2.1

بهبود عملکرد تایید پرداخت و نمایش خطاها.
نمایش شماره کارت پرداخت کننده در صورت ارسال از سمت بانک.

4.1.1

بهبود عملکرد در صورت خطای اتصال به سرور پی‌پینگ.
بهبود عملکرد دریافت شماره سفارش در تایید پرداخت.
نمایش کد پرداخت پی‌پینگ در سفارشات.

4.0.0

تغییرات در بخش نمایش جزئیات پرداخت.
هماهنگی بیشتر با افزونه پنل پی‌پینگ و بخش مغایرت‌گیری.
تغییر در ساختار اکشن‌های افزونه.

3.0.0

تغییر در پیام‌ خطاهای سفارش.
ثبت کد پرداخت برای هر سفارش و استفاده مجدد از آن برای تلاش‌های بعدی.
بهبود عملکرد کدهای واحد ارزی و نمایش خطاها.

2.8.0

برطرف شدن تداخل همسان‌سازی در برخی افزونه‌ها.

2.7.0

اضافه شدن شرط بیشتر‌ برای دریافت کد فاکتور در تایید پرداخت.

2.6.2

رفع خطاهای Notice در صفحه تسویه حساب.
استفاده از لوگوی کوچک‌تر برای نمایش درست لوگو در صفحه تسویه حساب.