WooCommerce
أضف تيرا باي كبوابة دفع إلى متجرك على WordPress وWooCommerce.
لم تُطلق بعد
إضافة تيرا باي لـ WooCommerce قيد التطوير ولم تُنشر بعد. تشرح هذه الصفحة طريقة الإعداد المرتقبة لتستعد مسبقًا. راسل support@teyra.co للوصول المبكر.
تضيف إضافة تيرا باي لـ WooCommerce بوابة دفع باسم Teyra Pay إلى صفحة الدفع. يُوجَّه العملاء إلى صفحة الدفع المستضافة في تيرا باي ثم يعودون إلى صفحة Order received في WooCommerce. لا تعلّم الإضافة الطلب مدفوعًا إلا بعد أن تتأكد من الدفع عبر واجهة تيرا باي البرمجية عند عودة العميل، أو عبر Webhook موقّع، وتظهر المدفوعات في لوحة تحكم تيرا باي مع القيمة woocommerce في channel.
المتطلبات
- WordPress 6.0 وWooCommerce 8.0 أو أحدث، مع تفعيل HTTPS. تعمل صفحة الدفع الكلاسيكية وكتل السلة والدفع (Cart/Checkout blocks)، والإضافة متوافقة مع تخزين الطلبات عالي الأداء (HPOS).
- PHP 7.4 أو أحدث.
- عملة متجر تدعمها تيرا باي (
KWDوSARوAEDوQARوBHDوOMRوJODوEGP). - حساب في تيرا باي. المدفوعات الحية تتطلب حسابًا معتمدًا.
الإعداد
ثبّت الإضافة
في لوحة إدارة WordPress افتح Plugins ← Add New، وارفع ملف الإضافة .zip (أو ابحث عن Teyra Pay بعد إدراجها)، ثم اضغط Activate.
أدخل مفتاح الـ API
افتح WooCommerce ← Settings ← Payments ← Teyra Pay. أبقِ Mode (الوضع) على Test (اختبار)، وألصق مفتاحًا سريًا للاختبار (sk_test_…) من المطورون ← مفاتيح API في لوحة تحكم تيرا باي في حقل Test secret key (المفتاح السري للاختبار)، ثم احفظ.
اربط الـ Webhooks
تعرض صفحة الإعدادات رابط الـ Webhook الخاص بمتجرك، مثل https://yourstore.com/wc-api/teyra_pay/ (أو https://yourstore.com/?wc-api=teyra_pay إذا لم تكن الروابط الدائمة مفعّلة). اضغط Connect webhooks (ربط الويب هوك) لتسجيله في تيرا باي للوضع المختار وحفظ سر التوقيع تلقائيًا، أو أضفه بنفسك من المطورون ← Webhooks وألصق سر التوقيع (whsec_…) في حقل Test webhook signing secret (سر توقيع الويب هوك للاختبار).
تتحقق الإضافة من ترويسة Teyra-Signature في كل Webhook، وتتجاهل الأحداث الخاصة بمتاجر أخرى أو بالوضع الآخر أو بمدفوعات لم تتم عبر WooCommerce.
اضبط صفحة الدفع
حدّد العنوان والوصف اللذين يراهما العملاء بالإنجليزية وبالعربية (يظهر النص العربي عندما تكون لغة الموقع العربية)، واختر لغة صفحة الدفع: لغة الموقع، أو العربية دائمًا، أو الإنجليزية دائمًا. فعّل البوابة واحفظ.
نفّذ طلبًا تجريبيًا
أنشئ طلبًا واختر تيرا باي وادفع ببطاقة اختبار في صفحة الدفع التجريبية. يجب أن ينتقل الطلب إلى Processing (أو Completed إذا كانت كل المنتجات افتراضية وقابلة للتنزيل). تعرض ملاحظات الطلب معرّف الدفع (pay_…)، وهو أيضًا رقم المعاملة (Transaction ID) للطلب.
انتقل إلى الوضع الحي
بعد اعتماد حسابك في تيرا باي، اضبط Mode على Live (مباشر)، وألصق مفتاحًا حيًا (sk_live_…) في حقل Live secret key (المفتاح السري المباشر)، واحفظ، ثم اضغط Connect webhooks مرة أخرى لربط نقطة Webhook حية. تُحفظ مفاتيح وأسرار Webhook الاختبار والوضع الحي كلٌّ على حدة، لذا يمكنك العودة إلى وضع الاختبار في أي وقت.
الاسترداد
استخدم زر Refund في صفحة الطلب في WooCommerce. ترسل الإضافة استردادًا كاملًا أو جزئيًا إلى تيرا باي وتضيف ملاحظة إلى الطلب بمعرّف الاسترداد (re_…) وحالته. إذا كان الاسترداد لا يزال قيد المعالجة، يضيف الـ Webhook ملاحظة أخرى عند اكتماله أو فشله. وتُضاف كذلك إلى طلب WooCommerce عمليات الاسترداد التي تجريها من لوحة تحكم تيرا باي.
حل المشكلات
| المشكلة | ما الذي تتحقق منه |
|---|---|
| تبقى الطلبات Pending payment | عمليات تسليم الـ Webhook في لوحة تحكم تيرا باي. قد تحجب إضافات الحماية أو جدار الحماية طلبات POST إلى رابط الـ Webhook. |
رسالة "Invalid signature" في السجلات (فعّل Debug log؛ تجد السجلات في WooCommerce ← Status ← Logs بالمصدر teyra-pay) | أن سر التوقيع في الإضافة يطابق سر نقطة النهاية، وأن وضع نقطة النهاية (اختبار/حي) يطابق وضع مفتاح الـ API. |
| المبالغ غير صحيحة | أن عدد المنازل العشرية لعملة المتجر يطابق المنازل العشرية للعملة (3 للدينار الكويتي والبحريني والأردني والريال العُماني). |