في هذه الصفحة
ما ستفعله#
تعرف إلى أي بيئة يذهب الاستدعاء، وأي مفتاح يخصّها، وما الذي يختلف بين البيئتين.
قبل أن تبدأ#
لديك حساب. أنشأ لك التسجيل تطبيقين: أحدهما لبيئة Sandbox والآخر لبيئة الإنتاج، ولكلٍّ منهما مفتاحه (التطبيقات والمفاتيح).
البيئتان#
لكل بيئة عنوان بوابة خاص بها يظهر في صفحة المنتج. المفتاح مرتبط ببيئة التطبيق الذي يملكه: استخدم مفتاح البيئة التي تستدعيها. ولا يمنح المفتاح الوصول إلا إلى المنتجات التي اشترك فيها تطبيقه.
| Sandbox | الإنتاج | |
|---|---|---|
| عنوان البوابة | gate-stg.api360.sa | gate.api360.sa |
| المفتاح | مفتاح تطبيق Sandbox | مفتاح تطبيق الإنتاج |
| البيانات | بحسب المنتج: خدمة الاختبار لدى المزوّد أو ردود محاكاة | حيّة من نظام المزوّد |
| الفوترة | لا نذكر سعراً هنا؛ راجع صفحة المنتج | صفحة المنتج وعقدك |
| موافقة المزوّد | غير مطلوبة للوصول المؤهَّل إلى Sandbox | مطلوبة لبعض المنتجات |
لأن المفاتيح مرتبطة ببيئة واحدة، سمِّ متغيّراتك باسم البيئة: SANDBOX_KEY لتطبيق Sandbox وAPI360_KEY للإنتاج. عندها يظهر فوراً المفتاح الموضوع في المتغيّر الخطأ.
مفتاح Sandbox لا يتطلب التحقق من المنشأة ولا دفعاً، بحدود ثابتة وببيانات اختبار منشورة. حالياً يجري الاختبار في بيئة Sandbox للمنتجات التي فعّلها مزوّدها.
أسئلة من صفحات المساعدة القديمة#
جاءت هذه الأسئلة من موقع المساعدة السابق (docs.api360.sa)، والإجابات أدناه هي ما تفعله المنصة اليوم.
ما بيئة الإنتاج؟#
البيئة الحيّة التي تُعالَج فيها البيانات الحقيقية والمدفوعات الفعلية. تذهب الاستدعاءات إلى gate.api360.sa بمفتاح تطبيق الإنتاج. وتتطلب بعض المنتجات موافقة المزوّد قبل أن يصبح اشتراكك فعّالاً.
ما Sandbox؟#
البيئة التي تختبر فيها تكاملك. تذهب الاستدعاءات إلى gate-stg.api360.sa بمفتاح تطبيق Sandbox، وتصل إلى خدمة الاختبار لدى المزوّد أو إلى ردود محاكاة ضبطها المزوّد. وشكل البيانات يعتمد على المنتج.
متى يلزم اعرف عميلك (KYC) أو اعرف منشأتك (KYB)؟#
حين يطلبه المنتج. يمكن للمزوّد أن يجعل منتجه مشروطاً بـ KYC أو KYB، وعندها يُرفض الاشتراك في المنتج أو تجديده حتى يكتمل KYC أو KYB في ملفك. ولا يُطلب ذلك مرة أخرى من عضوٍ في منشأة حسابها فعّال. أما المنتجات التي لا تشترطه فلا تحتاج إلى أيٍّ منهما.
تحقق من النتيجة#
- يصل الاستدعاء بمفتاح Sandbox إلى
gate-stg.api360.saإلى خدمة الاختبار الخاصة بالمنتج. - الرد
403معNo active subscription for this productيعني في الغالب مفتاحاً من البيئة الأخرى، أو منتجاً لم يشترك فيه تطبيقك.