Skip to main content

الأمان

1. احمِ مفاتيح API الخاصة بك

لا تكشف أبداً عن مفاتيح API في كود frontend أو المستودعات العامة!

2. Backend فقط

استدعِ دائماً API Navio من backend، ولا تفعل ذلك أبداً من frontend:

3. تحقق من المدخلات

4. تحقق قبل التنفيذ

تحقق دائماً من حالة الدفع في backend قبل تنفيذ الطلبات!

معالجة الأخطاء

معالجة أخطاء API

الاختبار

استخدم Sandbox

اختبر بمفاتيح sandbox قبل الإنتاج:

سيناريوهات الاختبار

اختبر هذه الحالات:
  • ✅ دفع ناجح
  • ✅ دفع فاشل
  • ✅ انتهاء صلاحية رابط الدفع (20 دقيقة)
  • ✅ العميل يعود دون دفع
  • ✅ أخطاء API

قائمة تحقق الإنتاج

قبل الإطلاق:

الأمان

  • مفاتيح API في متغيرات البيئة
  • لا استدعاءات API من frontend
  • التحقق من المدخلات منفَّذ
  • HTTPS مُفعَّل

الوظائف

  • إنشاء الطلب يعمل
  • روابط الدفع تُولَّد بشكل صحيح
  • التحقق من الحالة يعمل
  • تنفيذ الطلبات فقط عند CONFIRMED
  • مهمة cron تعمل

الاختبار

  • اختبار sandbox مكتمل
  • جميع الحالات الحدية مختبرة
  • معالجة الأخطاء مُتحقَّق منها

المراقبة

  • تسجيل الأخطاء مُفعَّل
  • إمكانية عرض الطلبات المعلقة
  • إمكانية التحقق اليدوي من الحالة

الأخطاء الشائعة

تجنّب هذه الأخطاء:
  • ❌ ترميز مفاتيح API مباشرةً في الكود
  • ❌ استدعاء API من frontend
  • ❌ عدم حفظ paymentRef
  • ❌ التنفيذ دون التحقق
  • ❌ غياب معالجة الأخطاء
  • ❌ التحقق بتكرار مفرط (احترم حدود معدل الطلبات)
  • ❌ عدم الاختبار في sandbox أولاً

أفضل ممارسات قاعدة البيانات

أضف فهارس لتحسين الأداء:

التسجيل

سجّل الأحداث المهمة:

الخطوات التالية

مرجع API

توثيق API الكامل

التواصل مع الدعم

احصل على مساعدة فريقنا

لوحة التحكم

راقب مدفوعاتك

دليل الأمان

ممارسات أمان متقدمة

أنت جاهز! 🎉

أصبح لديك الآن كل ما تحتاجه لقبول المدفوعات عبر Navio. ابدأ بالـ sandbox، اختبر بدقة، ثم انشر في الإنتاج!