VibeFox iPay88 for WooCommerce — المساعدة

المتطلبات

WordPress: 6.0 أو أحدث.

WooCommerce: 7.0 أو أحدث، مثبّت ومفعّل. بدون WooCommerce لا تُفعَّل الإضافة.

PHP: 8.0 أو أحدث.

حساب تاجر iPay88: يُصدر iPay88 مفتاح Merchant Code ومفتاح Merchant Key عند تفعيل حساب التاجر الخاص بك. وهما معروضان أيضًا في بوابة التجار لدى iPay88. وإذا لم تكن تاجرًا بعد، فقدّم طلبًا على موقع iPay88. احتفظ بمفتاح Merchant Key سرًا، فهو يوقّع المدفوعات.

Request URL: يجب تسجيل عنوان موقعك لدى iPay88 كعنوان Request URL. وإلا فستعرض صفحة iPay88 الرسالة "Permission not allow".

عملة المتجر: Malaysia — MYR، وUSD وSGD وAUD وCAD وEUR وGBP وHKD وCNY وTWD وINR وIDR وPHP أو THB إذا كان خيار تعدد العملات مفعّلًا في حساب iPay88 الخاص بك؛ وPhilippines — PHP أو USD؛ وIndonesia — IDR؛ وThailand — THB.

مفتاح ترخيص VibeFox: يُشترى من vibefox.net. ويعمل المفتاح الواحد على نطاق واحد فقط.

التثبيت

1. في WordPress، انتقل إلى Plugins > Add New > Upload Plugin، واختر ملف ZIP للإضافة، ثم انقر على Install Now. يمكنك أيضًا رفع المجلد wcp_ipay88_payment إلى /wp-content/plugins/ عبر FTP.

2. انقر على Activate.

3. افتح الإعدادات: WooCommerce > Settings > Payments > iPay88 > Manage، أو انقر على Settings أسفل اسم الإضافة في صفحة Plugins.

4. أدخل مفتاح ترخيص VibeFox في كتلة الترخيص أعلى الصفحة، ثم انقر على Activate.

5. اختر iPay88 region الخاصة بك، وأدخل Merchant Code وMerchant Key (راجع الإعدادات).

6. فعّل Enable/Disable. وللتحقق من الإعداد، أجرِ دفعة مع تفعيل Test mode، ثم أوقف وضع الاختبار.

الإعدادات

توجد جميع الإعدادات في صفحة واحدة: WooCommerce > Settings > Payments > iPay88. وفوق الحقول، تحذّرك الصفحة عند غياب Merchant Code أو Merchant Key (فلا تظهر طريقة الدفع عندها في صفحة الدفع)، وعند تعذّر خصم عملة المتجر في المنطقة المختارة، وطوال تفعيل وضع الاختبار. وفي قائمة طرق الدفع، يُعلَّم iPay88 بأنه يحتاج إلى إعداد حتى يُدخَل المفتاحان، ويظهر شارة وضع الاختبار طالما كان مفعّلًا.

عام

Enable/Disable: يفعّل Enable iPay88 Payment Gateway طريقة الدفع أو يوقفها. الافتراضي: إيقاف.

Title: اسم طريقة الدفع الذي يراه العملاء في صفحة الدفع. الافتراضي: iPay88.

Description: النص الذي يظهر أسفل طريقة الدفع في صفحة الدفع. الافتراضي: Pay securely via iPay88 (credit card, online banking, e-wallet).

حساب iPay88

iPay88 region: بلد حساب التاجر الخاص بك لدى iPay88. وهو يحدّد صفحة الدفع الخاصة بـ iPay88 والعملات التي يمكن خصمها. ويُخصم الطلب دائمًا بعملته. الافتراضي: Malaysia.

Merchant Code: رمز التاجر Merchant Code الخاص بك لدى iPay88، مثل M01234.

Merchant Key: مفتاح Merchant Key الخاص بك لدى iPay88. وهو يوقّع طلبات الدفع ويتحقق من ردود iPay88. احتفظ به سرًا.

Signature type: كيفية توقيع طلبات الدفع. وتُتحقَّق الردود بكلا الصيغتين.

الدفع

Payment method: اختر مسبقًا طريقة دفع واحدة من iPay88 من قائمة PaymentId الماليزية، أو اترك Let the customer choose on the iPay88 page (الافتراضي). وتشمل القائمة Credit Card (MYR) وFPX (Online Banking) وMaybank2U وAlliance Online وAmBank وRHB Bank وHong Leong Bank وCIMB Clicks وWeb Cash وPayPal (MYR) وCredit Card (PHP) وBoost وTouch n Go eWallet وGrabPay وShopeePay.

Reference prefix: اختياري. يُضاف قبل رقم الطلب في مرجع iPay88 (RefNo)، مثل SHOP1-. اضبط بادئة مختلفة في كل متجر يستخدم حساب iPay88 نفسه، حتى لا يُطبَّق ردّ متجر على طلب متجر آخر أبدًا. الحروف والأرقام و"-" و"_"، حتى 10 أحرف. والبادئة التي تنتهي برقم تُصحَّح عند الحفظ، لأن رقم الطلب يُقرأ من نهاية المرجع.

Test mode: Charge a fixed test amount instead of the order total. لا يوفّر iPay88 بيئة اختبار (sandbox) منفصلة: فدفعات الاختبار معاملات حقيقية في صفحة iPay88 الفعلية بمبلغ صغير (1.00؛ IDR 10,000). ويُعلَّم الطلب كمدفوع عند استلام مبلغ الاختبار، وتذكر ذلك ملاحظة الطلب. وطوال تفعيل وضع الاختبار تعرض صفحة الدفع الرسالة TEST MODE: only a test amount of ... will be charged. لا تترك وضع الاختبار مفعّلًا أبدًا في متجر فعلي. الافتراضي: إيقاف.

روابط الرد وbackend

ترسل الإضافة الرابطين مع كل دفعة، فلا حاجة إلى ضبطهما. وإذا طلبهما iPay88، فانسخهما من هذا القسم في الإعدادات. وتبدو هكذا: https://your-site/wc-api/ipay88_p_response/ (Response URL، عودة العميل) وhttps://your-site/wc-api/ipay88_p_backend/ (Backend URL، إشعار الخادم إلى الخادم). ويعرض القسم أيضًا عنوان موقعك، الذي يجب تسجيله لدى iPay88 كعنوان Request URL.

يُتحقَّق من الردّين من iPay88 بالطريقة نفسها: التوقيع المُنشأ بمفتاح Merchant Key، ومرجع دفعة بدأها هذا المتجر لهذا الطلب، والمبلغ والعملة. تُرفض الطلبات بدون توقيع صالح، ولا تغيّر الطلب أبدًا. ولا يتلقى إشعار backend الردّ RECEIVEOK إلا بعد معالجته، وإلا أعاد iPay88 إرساله. ويُبلغ iPay88 بحالات الدفع التالية:

متقدم

Debug log: Log payment requests and iPay88 responses في WooCommerce > Status > Logs، والمصدر wcp_ipay88_payment، بدون بيانات شخصية أو توقيعات. وتُسجَّل الأخطاء دائمًا. الافتراضي: إيقاف.

Delete data on uninstall: Delete the settings, logs and iPay88 order data when the plugin is deleted. الطلبات نفسها لا تُحذف أبدًا. الافتراضي: إيقاف.

الدفع

يختار العميل طريقة الدفع (افتراضيًا iPay88) ويقدّم الطلب. يبقى الطلب في حالة Pending payment، ويرى العميل الرسالة Redirecting to iPay88 payment gateway... أثناء إرسال نموذج إلى صفحة الدفع الخاصة بـ iPay88 في منطقتك. ومن دون JavaScript، ينقر العميل على Pay Now. وتُنقل عناصر الطلب، واسم العميل وبريده الإلكتروني وهاتفه، إلى iPay88. وفي صفحة iPay88 يدفع العميل ببطاقة أو عبر FPX للخدمات المصرفية الإلكترونية أو محفظة إلكترونية أو بوسيلة أخرى يتيحها حسابك.

بعد الدفع، يعود العميل إلى صفحة استلام الطلب في متجرك. ولا يُعلَّم الطلب كمدفوع إلا بعد أن يؤكد iPay88 الدفعة بردّ موقَّع، سواء عند عودة العميل أو عبر إشعار backend. وإذا لم يصل التأكيد بعد، تعرض الصفحة الرسالة We have not received the payment confirmation from iPay88 yet. If you completed the payment, your order will be updated shortly. وفي حالة الدفع المعلّق تعرض Your payment is pending confirmation from iPay88. We will update your order as soon as the payment is confirmed.

إذا فشلت الدفعة أو أُلغيت، يصل العميل إلى صفحة Pay for order مع الرسالة The payment was not completed: وسبب iPay88، ويمكنه أن يدفع مرة أخرى أو يختار طريقة دفع أخرى. وإذا تعذّر التحقق من الرد، يرى العميل الرسالة The payment response could not be verified. If you completed the payment, please contact us with your order number — the payment will be checked manually. مع رابط للعودة إلى المتجر.

يُخصم المخزون عند تأكيد الدفع، وليس عند توجيه العميل. وتعمل طريقة الدفع في الدفع الكلاسيكي، وكتلة Checkout، وصفحة Pay for order. وهي متوافقة مع WooCommerce High-Performance Order Storage (HPOS).

تقبل الإضافة المدفوعات لمرة واحدة فقط. ولا تتضمن استردادات من WooCommerce، ولا بطاقات محفوظة، ولا اشتراكات، ولا تفويضًا مسبقًا وتحصيلًا، ولا حقول بطاقة في موقعك. ولا تعيد الاستعلام من iPay88 عن حالة الدفع: تُحدَّث الطلبات فقط من رد iPay88 ومن إشعار backend. ولا تُستخدم واجهة iPay88 Indonesia API 2.0 (JSON / رابط الدفع).

الطلبات

Order statuses

Pending payment: أُرسل العميل إلى iPay88 ولم يدفع بعد، أو لم يؤكد iPay88 الدفعة بعد.

Processing or Completed: تم تأكيد الدفعة. تضبط WooCommerce الحالة المعتادة للطلب المدفوع. وتعرض ملاحظة الطلب معرّف TransID وPaymentID والمبلغ والعملة من iPay88. ومعرّف المعاملة هو TransID من iPay88. وفي وضع الاختبار، تذكر ملاحظة ثانية أن مبلغ الاختبار خُصم بدلًا من إجمالي الطلب.

On hold, pending at iPay88: أبلغ iPay88 بأن الدفعة معلّقة. وسيُحدَّث الطلب عندما يؤكد iPay88 الدفعة أو يُفشلها.

On hold, for review: أبلغ iPay88 بدفعة ناجحة بمبلغ أو عملة تختلف عن الطلب، أو وصلت الدفعة بعد إلغاء الطلب. ولم يُعلَّم الطلب كمدفوع. وتشرح ملاحظة الطلب ذلك. تحقق من الدفعة في بوابة iPay88، ثم أكمل الطلب أو استرد الدفعة.

Failed: فشلت الدفعة أو أُلغيت. وتعرض الملاحظة سبب iPay88. ويمكن للعميل الدفع مرة أخرى.

إذا وصلت دفعة ناجحة أخرى لطلب مدفوع أو مسترد بالفعل، فلا يتغيّر الطلب. وتطلب منك ملاحظة التحقق منها في بوابة iPay88 واستردادها إذا كانت مكررة. ولا يغيّر الردّ الفاشل أي طلب مدفوع أو مسترد أو ملغى أبدًا.

الاستردادات

لا تُرسل الاستردادات من WooCommerce إلى iPay88. استرد الدفعة من بوابة التاجر لدى iPay88، وسجّل الاسترداد يدويًا في WooCommerce.

مفتاح الترخيص

تعمل الإضافة بمفتاح ترخيص VibeFox من vibefox.net. وكتلة الترخيص موجودة في أعلى WooCommerce > Settings > Payments > iPay88. الصق المفتاح في License key وانقر على Activate. وتعرض الكتلة الحالة، مثل التاريخ الذي يبقى فيه الترخيص فعالًا، ونطاقك. استخدم Check now للتحقق من الحالة مجددًا، وChange key لإدخال مفتاح آخر، وRemove key لإزالة المفتاح من هذا الموقع. ويفتح الرابط Manage licenses and domains in your account حسابك في vibefox.net.

يعمل المفتاح الواحد على نطاق واحد فقط. وإزالة المفتاح من موقع لا تحرر خانة النطاق. حرّرها من حسابك في vibefox.net.

بدون مفتاح فعّال لا يظهر iPay88 للعملاء في صفحة الدفع. وإذا بدأت دفعة مع ذلك، يرى العميل الرسالة This payment method is not available. Please choose another one. ويظل مديرو المتجر الذين سجّلوا الدخول يرون طريقة الدفع، مع علامة (unlicensed — visible to admins only)، حتى تتمكن من إعداد الإضافة واختبارها قبل شراء مفتاح. ويظهر تذكير في صفحة Plugins وفي صفحات WooCommerce. ولا تتأثر الطلبات الحالية: فالدفعات التي بدأت بالفعل تظل تُؤكَّد.

عندما ينتهي الترخيص، تواصل الإضافة العمل، لكن التحديثات والدعم تتطلب التجديد. وتُعاد مراجعة الحالة تلقائيًا في الخلفية.

استكشاف الأخطاء وإصلاحها

لا يظهر iPay88 في صفحة الدفع: تحقق من أن الترخيص فعّال، وأن Enable/Disable مفعّل، وأن Merchant Code وMerchant Key مُدخلان، وأن عملة المتجر يمكن خصمها في iPay88 region المختارة. وتعرض صفحة الإعدادات تحذيرًا عند غياب شيء ما.

تمت الدفعة لكن الطلب بقي في Pending payment: لم يصل إلى متجرك لا رجوع العميل ولا إشعار backend بتوقيع صالح. فعّل Debug log وراجع WooCommerce > Status > Logs، والمصدر wcp_ipay88_payment. تحقق من أن Merchant Key مطابق تمامًا للمفتاح الذي منحه iPay88، وأن موقعك يستطيع استقبال طلبات iPay88 على عنوان Backend URL المعروض في الإعدادات.

تعرض صفحة iPay88 الرسالة "Permission not allow": عنوان موقعك غير مسجّل لدى iPay88 كعنوان Request URL. اطلب من iPay88 تسجيل العنوان المعروض في قسم Response and backend URLs.

يرد إشعار backend بالرسالة BAD SIGNATURE: التوقيع لا يطابق Merchant Key. تحقق من Merchant Key.

يرد إشعار backend بالرسالة NOT CONFIGURED: لم يُضبط Merchant Code أو Merchant Key، لذلك لا يمكن التحقق من الرد. يعيد iPay88 إرسال الإشعار.

يرد إشعار backend بالرسالة UNKNOWN ORDER: لم تُبدأ دفعة iPay88 لهذا المرجع في هذا المتجر، مثلًا لأن متجرًا آخر على الحساب نفسه لا يستخدم Reference prefix أو يستخدم البادئة ذاتها.

الطلب في حالة On hold مع ملاحظة عن المبلغ أو العملة: أبلغ iPay88 عن دفعة لا تطابق الطلب، أو كان الطلب قد أُلغي. ولم يُعلَّم الطلب كمدفوع. تحقق من الدفعة في بوابة iPay88، ثم أكملها أو استردها.

يرى العميل الرسالة "iPay88 cannot accept payments in" مع عملة: لا يمكن خصم عملة الطلب في المنطقة المختارة. وفي iPay88 Malaysia، تحتاج العملات غير MYR أيضًا إلى خيار تعدد العملات في حسابك لدى iPay88.

يُخصم من العملاء الفعليين 1.00 فقط: Test mode مفعّل. أوقفه.

تعرض كتلة الترخيص خطأ: اتبع الرسالة الظاهرة في الكتلة. فمثلًا، إذا كان المفتاح مستخدمًا بالفعل على نطاق آخر، فحرّر خانة في حسابك على vibefox.net وانقر على Check now. وإذا تغيّر عنوان الموقع، فانقر على Check now لتفعيل المفتاح للنطاق الجديد. وإذا تعذّر الوصول إلى خادم التراخيص، تواصل الإضافة العمل بآخر حالة معروفة.

يمكن للمطورين تغيير رابط صفحة الدفع والعملات والمنازل العشرية ومبلغ الاختبار والأيقونة باستخدام الفلاتر ipay88_p_payment_url وipay88_p_supported_currencies وipay88_p_currency_decimals وipay88_p_test_amount وipay88_p_icon.

إلغاء التثبيت

إيقاف الإضافة يُبقي على جميع البيانات. ولإزالتها، أوقفها ثم احذفها من صفحة Plugins. ويُحذف مفتاح الترخيص وحالة الترخيص لهذه الإضافة دائمًا. أما إعدادات البوابة والسجلات وبيانات iPay88 المخزنة على الطلبات فلا تُحذف إلا إذا كان Delete data on uninstall مفعّلًا. وإلا فستبقى محفوظة لإعادة التثبيت لاحقًا. والطلبات نفسها لا تُحذف أبدًا، وتحتفظ بملاحظات الدفع ومعرّفات المعاملات.

iPay88 علامة تجارية مملوكة لصاحبها. هذه الإضافة غير تابعة لـ iPay88 ولا يعتمدها iPay88.