نظرة عامة
يوفر SDK Navio Python واجهة نظيفة وأصيلة لدمج مدفوعات Navio في تطبيقات Python الخاصة بك. مبني باستخدام تلميحات أنواع Python 3.8+ وdataclasses لأفضل تجربة للمطورين.API أصيل بـ Python
واجهة نظيفة مع تلميحات أنواع كاملة وdataclasses
آمن من حيث الأنواع
تعليقات توضيحية كاملة مع dataclasses وenums
التحقق من المدخلات
التحقق من جانب العميل للحصول على تغذية راجعة سريعة للأخطاء
اعتمادات محدودة
يتطلب فقط حزمة
requestsالمتطلبات
- Python 3.8 أو أحدث
- pip
التثبيت
قم بالتثبيت عبر pip:البدء السريع
1. تهيئة SDK
2. إنشاء رابط دفع
3. التحقق من حالة الدفع
مثال تجارة إلكترونية كامل
تدفق طلب تجارة إلكترونية كامل
تدفق طلب تجارة إلكترونية كامل
مرجع API
فئة Navio
نقطة الدخول الرئيسية لـ SDK.المنشئ
create_link(request)
ينشئ رابط دفع جديداً.يُرجع:يرفع: ValidationException (400)، UnauthorizedException (403)، ApiExceptioncheck_payment(payment_ref)
يتحقق من حالة دفع.يُرجع:يرفع: NotFoundException (404)، PaymentExpiredException (410)، ApiExceptionEnums
FeeMode
PaymentStatus
فئات الاستثناء
ValidationException - HTTP 400
ValidationException - HTTP 400
تُطلق عندما تكون بيانات الطلب غير صالحة (مثال: مبلغ خارج النطاق، حقول مطلوبة مفقودة).الخصائص:
message، status_code، request_id، error_dataNotFoundException - HTTP 404
NotFoundException - HTTP 404
تُطلق عندما لا يوجد مرجع الدفع.الخصائص:
message، status_code، request_id، error_dataPaymentExpiredException - HTTP 410
PaymentExpiredException - HTTP 410
تُطلق عند انتهاء صلاحية رابط الدفع. تنتهي صلاحية الروابط بعد 20 دقيقة من الإنشاء.الخصائص:
message، status_code، request_id، error_dataApiException - متنوعة
ApiException - متنوعة
الاستثناء الأساسي لجميع أخطاء API الأخرى. التقطه كخيار احتياطي.الخصائص:
message، status_code، request_id، error_dataمعالجة الأخطاء
التكامل مع الأطر
- Flask
- Django
- FastAPI
ملاحظات مهمة
انتهاء صلاحية الرابط - تنتهي صلاحية روابط الدفع بعد 20 دقيقة من الإنشاء. بعد انتهاء الصلاحية يصبح الحالة
FAILED.اختبار Sandbox - استخدم مفتاح API sandbox الخاص بك للاختبار. تحقق من
response.payment_link.is_sandbox لتأكيد وضع الاختبار.مرجع API
عرض نقاط نهاية API Navio
الدعم
التواصل مع فريق الدعم
GitHub
عرض الكود المصدري على GitHub

