مؤسسات sandbox
الـ sandbox نسخة تجريبية من مؤسستك الحية (live) في OrcaRail. تعمل تمامًا مثل النسخة الحية، لكنها تستخدم الشبكات التجريبية (testnets) فقط، فلا تنتقل أي أموال حقيقية أبدًا. استخدمها لبناء تكاملك واختباره، ثم انتقل إلى مؤسستك الحية عندما تكون جاهزًا.
كل مؤسسة إما حية أو sandbox، وهذا العلم الواحد يحدد كل ما يتعلق بها:
| مؤسسة حية | مؤسسة sandbox | |
|---|---|---|
| الشبكات والرموز | الشبكات الرئيسية فقط | الشبكات التجريبية فقط |
| مفاتيح API | ak_live_… / sk_live_… | ak_test_… / sk_test_… |
| أحداث الـ webhook | livemode: true | livemode: false |
| أرقام لوحة التحكم | المدفوعات الحية فقط | مدفوعات الـ sandbox فقط |
| صفحة الدفع المستضافة | دفع عادي | شريط «دفعة تجريبية»، ومحاكاة الدفع |
| أموال حقيقية | نعم | أبدًا |
لا تختلط بيانات الإنتاج والـ sandbox أبدًا: لكل مؤسسة مدفوعاتها وأرصدتها وسحوباتها ومنتجاتها ومفاتيح API والـ webhooks الخاصة بها. فريقك مشترك، لأن الـ sandbox تعكس أعضاء المؤسسة الحية وأدوارهم.
متى تستخدمها
- عند بناء تكامل أو تغييره (SDK أو REST API أو MCP أو WooCommerce أو Laravel Cashier).
- لاختبار الـ webhooks والاشتراكات والسحوبات من البداية إلى النهاية.
- لترك وكيل ذكاء اصطناعي يعمل مع OrcaRail دون لمس أموال حقيقية.