Skip to main content

نظرة عامة

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

بنية بيانات البطاقة

الطلبات المنفَّذة تحتوي على ثلاثة حقول رئيسية:
  • card_code : رمز الشحن القابل للإدخال (المعرّف الرئيسي)
  • num_trans : رقم معاملة اتصالات الجزائر (دليل الشراء)
  • date_traitement : طابع التوقيت للمعالجة
يجب تسليم الحقول الثلاثة للعميل.

مرجع API

GET /v3/internet/check-id/{id}

استرجاع تفاصيل البطاقة المنفَّذة

التخزين الآمن

شفّر رموز البطاقات دائماً قبل تخزينها:

طرق التسليم

1. التسليم عبر البريد الإلكتروني

2. العرض داخل التطبيق

3. التسليم عبر SMS

سير التسليم الكامل

تسجيل التدقيق

سجّل أحداث التسليم دون كشف بيانات البطاقة:

تعليمات الاستخدام حسب النوع

قدّم تعليمات واضحة لكل نوع خدمة:

قائمة التحقق الأمنية

1

توليد مفتاح تشفير

أنشئ مفتاح تشفير آمن بطول 32 بايت وخزّنه في متغيرات البيئة
2

التشفير قبل التخزين

شفّر دائماً card_code قبل الإدراج في قاعدة البيانات
3

التحقق من الملكية

تأكد أن معرّف المستخدم يتطابق مع الطلب قبل عرض البطاقة
4

استخدام HTTPS

تأكد من أن جميع طرق التسليم تستخدم نقلاً مشفراً
5

تسجيل التدقيق

سجّل أحداث التسليم دون تضمين الرموز الفعلية
6

تعليمات واضحة

قدّم تعليمات استخدام خطوة بخطوة لكل نوع خدمة

أفضل الممارسات

التشفير في حالة السكون

شفّر دائماً رموز البطاقة قبل تخزينها في قاعدة البيانات

HTTPS فقط

لا ترسل بطاقات عبر اتصالات غير مشفرة

التحقق من الملكية

تحقق أن المستخدم يملك الطلب قبل عرض البطاقة

لا سجلات نصية

لا تسجّل رموز البطاقة كنص عادي في أي مكان

تضمين التعليمات

قدّم دائماً تعليمات استخدام واضحة

سجل التدقيق

سجّل أحداث التسليم دون بيانات حساسة

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

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

نظرة عامة

العودة إلى نظرة عامة على التكامل

تتبع الحالة

استعلام تنفيذ الطلبات

أفضل ممارسات الأمان

إرشادات الأمان العامة

إرسال الشحنات

تقديم طلبات الشحن

تحميل المنتجات

جلب البطاقات المتاحة

مرجع API

التوثيق الكامل للـ endpoint