البيئات والإعداد

Sandbox وProduction

تتعمد مواصفات OpenAPI استخدام عناوين Placeholder حتى لا ينفذ المطور طلبًا ماليًا بالخطأ. يمنحك فريق LuxPay عنوان كل بيئة، والرموز، ومزودي الدفع المتاحين، والعملات والحدود. يجب أن تكون بيانات Sandbox صناعية، وألا تنسخ بيانات عملاء Production إليها.

إعداد موحد

عرّف متغيرات منفصلة لعنوان API، ورمز الوصول، وWebhook secret، واسم البيئة. امنع تشغيل رمز Sandbox مع Production والعكس عبر فحص عند بدء التطبيق. لا تستخدم شرطًا مبنيًا على اسم النطاق فقط؛ احتفظ بمعرف بيئة صريح.

اختلاف القدرات

قد تختلف الخدمات المتاحة في GET /payment-services بين البيئتين، كما قد تعيد Sandbox إجراءات تالية محاكية بدل اتصال مالي حقيقي. يجب أن يختبر العميل البيانات التي يعيدها API بدل افتراض وجود مزود أو قناة محددة.

بوابة الانتقال

قبل Production، نفذ سيناريوهات التسجيل والدخول، قراءة الرصيد، التحويل مع إعادة المحاولة، فشل الرصيد، الحجز والإفراج، الاسترداد، 429، والتحقق من Webhook مكرر. وثق نتائج الاختبار ومعرفات الطلبات. لا تستخدم نجاح واجهة واحدة دليلًا على أن دورة التسوية والمصالحة مكتملة.

عنوان الموقع

اضبط NEXT_PUBLIC_API_BASE_URL وNEXT_PUBLIC_SANDBOX_API_BASE_URL عند نشر هذه البوابة حتى تعرض أمثلة البيئة الصحيحة، دون وضع أسرار داخل متغيرات NEXT_PUBLIC_*.