نظرة عامة على واجهة LuxPay

ما الذي توثقه هذه البوابة؟

هذه البوابة هي المرجع التقني لواجهات محفظة LuxPay والمدفوعات المرتبطة بها. يغطي العقد المصادقة، المحافظ، الأرصدة، العمليات، التحويلات، الحجز والإفراج، دفتر الأستاذ، مدفوعات التجار، خدمات الدفع، الصرف، التسويات، التقارير، وWebhooks الخاصة بمزودي الدفع. أما الشرح التجاري وتجربة المستخدم فيوجد في موقع توثيق المنتج المنفصل.

مصدر الحقيقة

ملف OpenAPI الموجود داخل المستودع مشتق من تسجيل المسارات الفعلي وعمليات التحقق داخل Controllers في LuxApi. لا يعني وجود Endpoint في المرجع أنه متاح لكل عميل؛ حقل مستوى الوصول يوضح هل المسار للعميل، أو التاجر، أو الإدارة المالية، أو فريق تشغيل مقيّد. يتم اشتقاق هوية النشاط والفرع من سياق موثوق، ولا ينبغي إرسالها في جسم الطلب عندما ينص العقد على ذلك.

نموذج التكامل

ابدأ بالحصول على عنوان البيئة ورمز الوصول من LuxPay، ثم نفذ طلب الصحة، وأنشئ مفتاح Request ID لكل طلب. استخدم مفاتيح منع التكرار للعمليات المالية، واحفظ معرف العملية الذي يعيده الخادم بدل الاعتماد على نتيجة واجهة المستخدم وحدها. راجع المصادقة ومنع التكرار قبل أول عملية كتابة.

حدود الأمان

لا تضع الأسرار في تطبيق الهاتف أو المتصفح العام، ولا تسجل رموز الوصول أو كلمات المرور أو تواقيع Webhook. أمثلة الموقع تستخدم قيمًا صناعية فقط، وعناوين الخوادم الافتراضية غير صالحة للإنتاج حتى يتم تزويدك بالعناوين الرسمية.