المؤسسات والتطبيقات والبيئات

تضم المؤسسة فريقك وفوترتك؛ وتضم التطبيقات سير العمل ومفاتيح API، وكل تطبيق إما مباشر أو sandbox. ضبط هذا الهيكل بشكل صحيح يمنع معظم السلوكيات المربكة.

#المستويان

المؤسسة هي حسابك. وهي تمتلك:

• فريقك وأدوارهم
• رصيد فوترتك وفواتيرك
• سجل التدقيق الخاص بك
• جميع تطبيقاتك

التطبيق هو مساحة عمل داخل المؤسسة. وهو يمتلك:

• سير العمل الخاص به
• مفاتيح API الخاصة به
• نقاط نهاية webhook الخاصة به
• سياسة الاحتفاظ بالبيانات الخاصة به
• منتجاته الخاصة، حيثما طُرحت ميزة تفعيل المنتجات لكل تطبيق. راجع المنتجات وما تتضمنه
• بيئتان: الإنتاج وبيئة الاختبار

بدّل التطبيق من بطاقة التطبيق أعلى الشريط الجانبي. يسري التبديل فورًا. وتفتح القائمة نفسها إعدادات التطبيق وإنشاء تطبيق.

#لماذا هذا أهم مما يبدو

تعود جل بلاغات "غيّرت الأمر ولم يحدث شيء" إلى هذا الهيكل:

• عدّلت سير عمل في التطبيق A بينما تعمل جلساتك تحت التطبيق B.
• أضفت نقطة نهاية webhook إلى تطبيق ما وتوقعت أحداثًا من تطبيق آخر.
• تنظر إلى بيئة الاختبار بينما تعمل حركتك في الإنتاج، أو العكس.
• تستدعي باستخدام مفتاح من تطبيق مختلف عن المورد الذي تخاطبه، فتحصل على خطأ 404 أو 403 لشيء موجود بوضوح.

قبل تصحيح أي شيء آخر، تأكد من التطبيق. راجع أخطاء API ومعناها.

#الإنتاج وبيئة الاختبار بيئتان منفصلتان

التطبيقات الجديدة تكون في الإنتاج. أما الاختبار فيجري في بيئة الاختبار: تطبيق الاختبار المشترك لمؤسستك، ببياناته الخاصة ومفاتيحه الخاصة. بدّل بينهما عبر زر الإنتاج وبيئة الاختبار أسفل اسم التطبيق في الشريط الجانبي.

عمليات التحقق ومفاتيح API والـ webhooks والقوائم منفصلة في كل بيئة. أما الهوية البصرية فمشتركة، وسير العمل يُبنى مرة واحدة ويمكن نسخه بين البيئتين. هذا الفصل هو بيت القصيد: فحركة الاختبار وبيانات الإنتاج لا تختلطان أبدًا، ولا يمكن لمفتاح sandbox أن ينفق رصيدًا حقيقيًا عن طريق الخطأ. راجع الاختبار في sandbox.

#كم عدد التطبيقات التي ينبغي أن تمتلكها؟

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

• لكل منتج، عندما تحتاج المنتجات المختلفة إلى سير عمل ونقاط نهاية webhook مختلفة.
• لكل بيئة ما قبل الإنتاج، إذا كنت تحتاج إلى أكثر من بيئة اختبار واحدة.
• لكل علامة تجارية، إذا كنت تقدّم التحقق تحت عدة علامات تجارية بأنماط مختلفة.
• لكل سياسة احتفاظ، بما أن الاحتفاظ يُضبط لكل تطبيق على حدة.

ما لا ينقسم حسب التطبيق: رصيدك، وهو على مستوى المؤسسة. كل تطبيق يسحب من الرصيد نفسه.

#إنشاء تطبيقات إضافية

افتح بطاقة التطبيق أعلى الشريط الجانبي واختر إنشاء تطبيق، ثم أدخل اسم التطبيق (وحيثما طُرحت ميزة المنتجات لكل تطبيق، تختار أيضًا الغرض منه). إذا كان الخيار مفقودًا، أو احتجت إلى إنشاء تطبيق عبر API بدلًا من الكونسول، فهذه مسألة صلاحيات على مستوى الحساب تستحق سؤال الدعم عنها بدلًا من الالتفاف حولها.

#مؤسسات متعددة

يمكن للشخص الواحد أن ينتمي إلى عدة مؤسسات، ويبدّل بينها من قائمة المؤسسة أعلى الشريط الجانبي، حيث تظهر أيضًا الدعوات المعلّقة. إنشاء أكثر من مؤسسة بنفسك مقصور على حسابات الموزعين (تواصل مع الدعم لتفعيله)، ولا توجد طريقة لإنشاء مؤسسات فرعية أو حسابات فرعية تحت مؤسستك. إذا كنت تخدم عدة عملاء لك، فالبنية المدعومة هي تطبيق واحد لكل عميل داخل مؤسستك الوحيدة: لكل تطبيق مسارات عمله وعلامته التجارية ومفاتيح API ونتائجه وتقارير استخدامه، معزولة تمامًا عن غيرها، بينما تبقى الفوترة على مستوى مؤسستك.

#إعادة بيع Didit

إذا أردت دمج Didit في منتجك وتحصيل رسوم من عملائك مقابله، فهذا هو نموذج الموزع. وإليك كيف يعمل، بالشروط التي يقدمها الدعم لكل من يسأل:

• رصيد مدفوع مسبقًا. حد أدنى للشراء الأولي قدره 5,000 دولار أمريكي، مدفوع مسبقًا، باتفاقية لمدة سنة. لا تنتهي صلاحية الرصيد، ويقع على مستوى مؤسستك ويُستهلك عبر جميع العملاء النهائيين الذين تضيفهم، ويتضمن خصمًا على الحجم يزداد مع المبلغ.
• أنت تبني لوحة التحكم. تدمج API الخاصة بـ Didit في واجهتك الأمامية، ويدير عملاؤك هناك مسارات عملهم وعلامتهم التجارية وأدوارهم. Didit لا توفر نسخة بعلامة بيضاء من Business Console؛ شاشات التحقق التي يراها المستخدمون النهائيون يمكن أن تحمل علامتك التجارية (راجع العلامة البيضاء)، أما وحدة التحكم فلا.
• هامش ربحك لك. أنت تحدد السعر الذي يدفعه عملاؤك. تفوترك Didit لكل ميزة مكتملة بأسعار الوحدة الثابتة طوال مدة الاتفاقية.
• ليس برنامج شركاء محليين. تجري Didit العروض التوضيحية والتهيئة والدعم مباشرة مع العملاء ولا تبحث عن شركاء توزيع أو تنفيذ.

إذا فضّلت عدم التعامل مع إعادة البيع، فاستخدم خيار الإحالة بدلًا من ذلك: في Business Console، افتح الإعدادات ← ادعُ واربح، واحصل على رابطك وشاركه. تكسب عمولة 10% على كل إيداع نقدي تقوم به مؤسسة محالة، لمدة 36 شهرًا من أول إيداع لها، قابلة للاستخدام كرصيد Didit أو للسحب بتحويل مصرفي بعد فترة النضج، دون أي التزامات تسليم أو دعم. يمكنك بناء تكاملك واختباره في الباقة المجانية قبل الالتزام بأي من الخيارين.

#حذف تطبيق

الحذف النهائي للتطبيق غير متاح بعد: تحتوي إعدادات التطبيق على منطقة الخطر، لكنها تذكر أن الحذف غير متاح ولا تحذف شيئًا. خياراتك إلى ذلك الحين:

• توقف عن استخدامه. أعد تسميته (مثل acme-old) حتى لا يختاره أحد عن طريق الخطأ، وألغِ مفاتيح API الخاصة به ضمن المطورون ← مفاتيح API.
• امحُ بيانات عملائه. تتبع بيانات التحقق سياسة الاحتفاظ وقواعد الحذف الخاصة بتلك البيانات، لا دورة حياة التطبيق - احذف البيانات صراحةً. راجع حذف الجلسات والبيانات الشخصية.
• ابدأ من جديد. يمكن للدعم حذف المؤسسة بأكملها حتى تتمكن من إنشاء مؤسسة جديدة - وهذا حل أخير، لأنه يحذف معها الفريق والرصيد والسجل.

#كل شيء قابل للإسناد

كل تغيير يسجّل التطبيق الذي ينتمي إليه، في سجل التدقيق. هذا ما يجعل هيكل التطبيقات المتعددة قابلاً للتدقيق لا مجرد هيكل مرتب. راجع استخدام سجلات التدقيق.