ربط XPay بمتجرك: كروت وفوري وفاليو

XPay بتديك في ربط واحد الدفع بالكروت وفوري وفاليو. على ستورك بلس تقدر تضيفها كطريقة دفع وتستقبل بيها من عملاء المتجر ومن واتساب وماسنجر وإنستجرام. الإعداد 4 خانات ورابط Webhook واحد.

باختصار

الإعداد من: الإعدادات ← طرق الدفع ← إنشاء ← XPay (cards, Fawry, ValU).
هتحتاج المفتاح السري (sk_test أو sk_live) وسر الـ Webhook (whsec).
تختار لغة صفحة الدفع: زي لغة الطلب، أو عربي، أو إنجليزي.
رقم إعدادات وسائل الدفع اختياري، بيحدد تظهر كروت ولا فوري ولا فاليو.
الطلب بيتأكد مدفوع عن طريق الـ Webhook، فلازم تضيفه.

الخطوة 1: أنشئ طريقة دفع XPay

من لوحة تحكم متجرك افتح الإعدادات ← طرق الدفع، ودوس إنشاء، واختار XPay (cards, Fawry, ValU). اكتب الاسم اللي العميل هيشوفه بالعربي والإنجليزي.

الخطوة 2: المفتاح السري (Secret API key)

من لوحة XPay افتح Developers ← API keys. استخدم مفتاح sk_test_ وإنت بتجرّب، وبعد ما حسابك يتفعّل غيّره لـ sk_live_.

الخطوة 3: رابط الـ Webhook وسرّه

صفحة الإعداد في ستورك بلس بتوريك رابط Webhook ثابت لمتجرك. تقدر تضيفه حتى قبل ما تحفظ.
في لوحة XPay افتح Developers ← Webhooks ← Add endpoint والصق الرابط، واشترك في الأحداث اللي الصفحة بتقولك عليها.
XPay هتعرض لك سر بيبدأ بـ whsec_ مرة واحدة. انسخه في خانة Webhook signing secret.

مهم: الدفع بيتأكد عن طريق الـ Webhook. من غيره الطلبات هتفضل غير مدفوعة. وخلي بالك إن سر الاختبار غير سر التشغيل الفعلي.

الخطوة 4: لغة صفحة الدفع

خانة Checkout page language فيها 3 اختيارات: زي لغة الطلب (عربي أو إنجليزي حسب العميل)، أو عربي دايماً، أو إنجليزي دايماً.

الخطوة 5: وسائل الدفع اللي تظهر (اختياري)

لو عايز تحدد الكروت بس، أو تضيف فوري وفاليو، اكتب Payment method configuration ID. هتلاقيه في XPay من Settings ← Payment methods. سيبه فاضي لو هتستخدم الإعداد الافتراضي بتاع حسابك.

ملاحظة عن فوري

الدفع بفوري مش لحظي: العميل بياخد كود ويدفع بعدين. الطلب بيتأكد مدفوع لما XPay تبعت التأكيد على الـ Webhook.

قبل ما تفعّل XPay للعملاء

اعمل طلب تجريبي بالكارت التجريبي واتأكد إنه ظهر مدفوع.
جرّب فوري واتأكد إن الطلب بيستنى لحد التأكيد.
غيّر المفتاح وسر الـ Webhook لمفاتيح التشغيل في نفس الوقت.
فعّل طريقة الدفع على قناة البيع اللي بتبيع منها، سواء من المتجر أو من واتساب وماسنجر وإنستجرام.

أسئلة شائعة

هل XPay بتدعم فوري وفاليو على ستورك بلس؟

أيوه. طريقة الدفع اسمها XPay (cards, Fawry, ValU)، وإنت بتحدد الوسائل اللي تظهر من إعدادات حسابك في XPay.

ليه الطلب لسه غير مدفوع بعد ما العميل دفع؟

غالباً الـ Webhook مش متضاف في XPay أو السر غلط. الدفع بيتأكد عن طريق الـ Webhook، فاتأكد من الرابط وسر whsec_.

أجرب إزاي من غير فلوس حقيقية؟

استخدم مفتاح sk_test_ وسر الـ Webhook الخاص بالاختبار، وبعد ما تتأكد غيّرهم لمفاتيح التشغيل الفعلي.

اقرأ كمان

جرّبها بنفسك: افتح متجرك مجاناً على ستورك بلس — خطة البداية مجانية وبدون عمولة على المبيعات.