# مقدمة (/ar)
مدفوعات لكل الأعمال في مصر. اقبل البطاقات ووسائل الدفع المحلية عن طريق الـ API، أو صفحة دفع جاهزة، أو واجهتك الخاصة.
XPay منصة مدفوعات للأعمال الإلكترونية في مصر. بنقبل الدفع بالبطاقات ووسائل الدفع المحلية، وبنتولّى تحدّي الـ 3D Secure، وبنحوّل فلوسك لحسابك البنكي بمجرد ما تتم التسوية. فيه أربع طرق للدمج، وبتختار بينها على حسب حجم الكود اللي ناوي تكتبه.
## يعني إيه XPay؟ [#يعني-إيه-xpay]
اقبل Visa وMastercard جنب وسائل الدفع المحلية زي ڤاليو وفوري.
موارد على نمط Stripe، وSDKs حقيقية، وصفحة دفع جاهزة بمستوى منتج استهلاكي متقن. لو سبق لك الدمج مع
Stripe، هتلاقي نفسك في بيتك من أول يوم.
اقبل الدفعة، وادِر العميل، واعمل المبالغ المستردة، وحوّل فلوسك لحسابك. كل ده من لوحة تحكم واحدة وAPI
واحد، من لحظة البيع لحد البنك.
صفحات دفع بالعربي أو الإنجليزي، مصمّمة للموبايل أولًا، بشعارك وألوانك. من غير أي شغل تصميم علشان تبدأ.
## XPay بيتولّى عنك إيه [#xpay-بيتولّى-عنك-إيه]
Visa، Mastercard، ڤاليو، فوري، وغيرهم. API واحد لكل وسيلة دفع متاحة.
تحدّي الـ 3DS بيتم جوّه صفحة الدفع الجاهزة. إحنا بنتعامل مع تحويل البنك، والـ iframe، والنتيجة.
اشترك مرة واحدة، وإحنا بنبلّغك في اللحظة اللي بتنجح فيها الدفعة أو تفشل أو تترد. حمولات موقّعة، وإعادة
محاولة تلقائية، وقابلة لإعادة الإرسال من لوحة التحكم.
اعمل استرداد كامل أو جزئي من لوحة التحكم أو الـ API. العميل بيستلم فلوسه عن طريق نفس وسيلة الدفع
الأصلية.
بيئة منفصلة تمامًا بمفاتيحها وعملائها ومعاملاتها. استخدم قائمة بطاقات الاختبار علشان تحاكي أي نتيجة
محتاجها.
الأموال المُسوّاة بتوصل حسابك البنكي على حسب الجدول اللي تظبطه. كل قرش متتبَّع في سجل الرصيد.
## البداية السريعة [#البداية-السريعة]
خمس دقايق من تسجيل جديد لحد أول دفعة اختبار ناجحة، من غير أي كود. هتنشئ منتج، وتعمل رابط دفع، وتدفع لنفسك ببطاقة اختبار، وتتفرّج على المعاملة وهي بتوصل لوحة التحكم.
أسرع طريق يوديك في XPay من الأول للآخر. خمس خطوات، كلها من لوحة التحكم.
## اختار طريقة الدمج بتاعتك [#اختار-طريقة-الدمج-بتاعتك]
فيه أربع طرق لتحصيل المدفوعات مع XPay. كلها بتعتمد على نفس جلسة الدفع (Checkout Session)، فاستدعاء الـ API والـ webhook اللي بيوصلك واحدين في الطرق الأربعة. الفرق الوحيد هو حجم كود الواجهة (frontend) اللي هتكتبه، ومكان إدخال العميل لبيانات بطاقته.
لو محتار تختار إيه، ابدأ بروابط الدفع. تقدر تنتقل لدمج أغنى بعدين من غير ما تعيد كتابة الـ backend بتاعك.
شارك رابط. من غير أي كود خالص. الأنسب للفواتير، والبيع على السوشيال ميديا، وإثبات إن الدمج شغّال قبل ما
تكتب أول سطر.
السيرفر بتاعك بينشئ جلسة دفع ويحوّل العميل لصفحة XPay الجاهزة. أبسط طريق فيه أي كود.
صفحة الدفع الجاهزة بتفتح كنافذة منبثقة فوق موقعك، أو بتتضمّن داخليًا كـ iframe. العميل مش بيغادر نطاقك
أبدًا.
ابنِ واجهة دفع مخصّصة بالكامل باستخدام `` بتاع XPay. أقصى تحكم، وأكتر كود.
## مصمَّم للمطوّرين [#مصمَّم-للمطوّرين]
لما تكبر على الأساسيات، كل طبقة مكشوفة قدامك.
الصق أي معرّف XPay وشوف الرسم الكامل للموارد المرتبطة بيه، والأحداث اللي اتطلقت عليه، وسجلات الطلبات
اللي مسّته.
اضغط **إعادة إرسال** على أي تسليم سابق، وبيوصل معالِجك حدث جديد موقّع من غير ما تضطر تعيد تشغيل الدفعة
الأصلية.
كل استدعاء API عمله حسابك: الطريقة، والمسار، والحالة، والترويسات، والمحتوى، والرد. صفِّ حسب كود الخطأ،
وادخل بالتفصيل عن طريق معرّف الطلب.
أكواد أخطاء ثابتة مقترنة بروابط توثيق مباشرة. تلميح لوحة التحكم وسجلات أخطائك الخاصة، الاتنين بيوصّلوك
على طول للشرح.
آخر حالات الفشل مجمّعة حسب السبب الجذري، ومرتّبة حسب التكرار. اكتشف خلل أي نشر في ثواني.
`@xpayeg/sdk` للجافاسكريبت العادي، و`@xpayeg/react` لـ React. خفيفة، ومكتوبة بالأنواع، ومستقلة عن إطار
العمل.
## رايح فين بعد كده [#رايح-فين-بعد-كده]
اعمل أول دفعة اختبار في خمس دقايق، من غير أي كود.
مقارنة جنب بعض للأربع طرق مع شجرة قرار في الأول. اختار مرة واحدة وما ترجعش تفكّر تاني.
الخريطة الذهنية: إزاي جلسة الدفع، وPayment Intent، وCharge، وRefund، والعميل بيتركّبوا مع بعض، وأنهي
معرّفات تحتفظ بيها في سجل الطلب بتاعك.
كل نقطة نهاية، وكل حقل، وكل كود حالة. مولّدة من مواصفة OpenAPI الحيّة، وعمرها ما بتبقى قديمة.