WooCommerce
نزّل إضافة XPay for WooCommerce، اربط حسابك، واقبل المدفوعات في صفحة الدفع.
إضافة XPay for WooCommerce بتضيف XPay لصفحة الدفع في متجرك على WooCommerce. العميل بيدفع في حقول دفع آمنة جوّه صفحة الدفع بتاعتك، والطلبات المدفوعة بتتحدّث لوحدها. نزّلها من WordPress.org.
تقدر تعمل إيه
اقبل طرق الدفع اللي على حسابك
البطاقات وValU وفوري وApple Pay، حسب المتاح منها على حسابك في XPay.
أي صفحة دفع
بتشتغل مع صفحة الدفع العادية، وبلوكات السلة والدفع (Cart and Checkout blocks)، وصفحة دفع الطلب.
رد المبالغ من WooCommerce
استرداد كامل أو جزئي من صفحة الطلب.
عربي وإنجليزي
الإضافة وحقول الدفع بتاعتها بتمشي على لغة متجرك.
محتاج WordPress 6.2 أو أحدث، وWooCommerce 8.3 أو أحدث، وPHP 7.4 أو أحدث، ومتجرك يكون شغّال على HTTPS.
نزّل الإضافة واربط حسابك
نزّل الإضافة
من WordPress، روح على الإضافات ← أضف إضافة جديدة وابحث عن XPay for WooCommerce. اضغط التنصيب الآن، وبعدين تفعيل.
اربط حسابك على XPay
روح على WooCommerce ← الإعدادات ← المدفوعات ← XPay واضغط الاتصال بـ XPay. سجّل دخولك على XPay، اختار نشاطك التجاري ووافق. هترجع لـ WooCommerce وانت مربوط بحساب الاختبار، والـ webhook متظبط خلاص.
اختار طرق الدفع
افتح تبويب طرق الدفع. هتلاقي فيه طرق الدفع اللي حسابك بيقبلها بعملة متجرك. علّم على اللي عايزها تظهر وقت الدفع واضغط حفظ التغييرات. علشان تغيّر ترتيبها، اضغط تغيير ترتيب العرض، اسحب طرق الدفع، وبعدين اضغط حفظ ترتيب العرض.
اعمل طلب تجريبي
اشتري حاجة من متجرك بـ بطاقة اختبار. الطلب هيظهر مدفوع في WooCommerce أول ما الدفع ينجح. وضع الاختبار عمره ما بيخصم فلوس حقيقية.
لما XPay يشغّل طريقة دفع جديدة لحسابك، افتح قائمة طرق الدفع (⋮) واضغط تحديث طرق الدفع، وبعدين علّم عليها.
اتحوّل للحساب الفعلي
لازم حسابك على XPay يكون متوافق عليه للمدفوعات الفعلية الأول.
اربط حسابك الفعلي
في تبويب الإعدادات، اضغط اربط حسابك الفعلي تحت تفعيل الوضع التجريبي. اضغط اتصال بالحساب الفعلي ووافق على XPay. حسابك الفعلي بياخد مفاتيحه والـ webhook بتاعه؛ ربط الاختبار بيفضل زي ما هو.
اقفل وضع الاختبار
شيل العلامة من تفعيل الوضع التجريبي واضغط حفظ التغييرات. اعمل طلب حقيقي صغير واتأكد إن حالته بتتحدّث في WooCommerce.
علشان ترجع للاختبار، علّم على تفعيل الوضع التجريبي تاني. علشان تغيّر ربط أو تشيله، افتح القائمة (⋮) على كارت الحساب واضغط إعداد الاتصال أو فصل.
Apple Pay
Apple Pay بيظهر في تبويب طرق الدفع لما يكون متشغّل لحسابك على XPay. العميل بيدفع على موقعك، فـ Apple محتاجة تعرف متجرك الأول. الإضافة بتسيب Apple Pay مقفول لحد ما خطوتين يبقوا خلصانين في صف Apple Pay: الإعداد في لوحة تحكم XPay وملف التحقق من النطاق.
أضف الشهادات في لوحة تحكم XPay
اتبع أول تلات خطوات في اعمل إعداد Apple Pay لموقعك: الـ Merchant ID بتاعك من Apple والشهادتين. ارجع لـ WooCommerce واضغط حفظ التغييرات. الإعداد في لوحة تحكم XPay هيبقى مكتمل.
سجّل دومين متجرك عند Apple
في حساب Apple Developer، افتح الـ Merchant ID بتاعك وأضف دومين متجرك، مثلًا shop.example.com. نزّل ملف التحقق اللي Apple بتديهولك. ما تضغطش Verify لسه.
ارفع الملف على الإضافة
في صف Apple Pay، اضغط رفع الملف، اختار الملف اللي نزّلته، وبعدين اضغط حفظ التغييرات. الإضافة بتعرضه على https://your-domain/.well-known/apple-developer-merchantid-domain-association.txt، وملف التحقق من النطاق هيبقى موجود.
اتحقق من الدومين عند Apple
ارجع لـ Apple Developer واضغط Verify جنب الدومين بتاعك. Apple هتجيب الملف من متجرك وتعلّم إن الدومين اتحقق منه.
شغّل Apple Pay
علّم على Apple Pay في تبويب طرق الدفع واضغط حفظ التغييرات. Apple Pay هيظهر وقت الدفع كطريقة دفع لوحده.
لو ملف التحقق من النطاق فضل غير موجود، يبقى السيرفر بتاعك أو إضافة حماية بيمنعوا مسار .well-known، أو WordPress متسطّب جوّه فولدر فرعي. Apple محتاجة الملف على جذر الدومين بتاعك. صلّح ده، وبعدين اضغط حفظ التغييرات علشان تتأكد تاني.
رد المبالغ
افتح الطلب في WooCommerce، اضغط استرداد، اكتب المبلغ وأكّد الاسترداد عن طريق XPay. تقدر ترجّع المبلغ كله أو جزء منه. مدفوعات ValU ما ينفعش تترد عن طريق XPay.
لما حاجة ما تشتغلش
| اللي بتشوفه | معناه | تعمل إيه |
|---|---|---|
| XPay مش ظاهر في صفحة الدفع | مفيش طريقة دفع متعلّم عليها، أو مفيش طريقة بتدعم عملة المتجر. | علّم على طريقة دفع في طرق الدفع. ValU وفوري محتاجين الجنيه المصري (EGP). |
| حقول الدفع مش بتحمّل | إضافة تسريع، أو أداة موافقة، أو سياسة أمان بتمنع XPay. | اسمح بالسكريبتات والـ frames من https://checkout.xpay.app، وما تعملش كاش لصفحة الدفع. |
| العميل دفع والطلب لسه معلّق | XPay مش قادر يوصل للـ webhook بتاع متجرك. | افتح إعداد الاتصال واضغط إعادة إعداد الويب هوك. |
| مش قادر تعلّم على Apple Pay | خطوة من خطوتين Apple Pay لسه ما خلصتش. | اتبع Apple Pay لحد ما الاتنين يبقوا مكتمل وموجود. |
| محتاج تفاصيل أكتر | الإضافة تقدر تسجّل كل خطوة. | شغّل التسجيل التشخيصي في الإعدادات، وبعدين افتح WooCommerce ← الحالة ← السجلات واختار سجل xpayeg. |
السجلات عمرها ما بتشيل مفاتيح، ولا بيانات بطاقات، ولا بيانات شخصية للعملاء.