تكامل eSIM API
تكامل Airalo API: بيعوا eSIM مع كل رحلة
اربطوا حساب شريك Airalo بمنصة PHPTRAVELS وبيعوا شرائح eSIM محلية وإقليمية وعالمية على موقعكم، إلى جانب الرحلات الجوية والفنادق والجولات. الموصل جاهز: أضيفوا Client ID وClient Secret، واختبروا في بيئة الاختبار، وزامنوا الباقات، وحددوا سعركم، ثم انطلقوا.
- موصل Airalo جاهز
- Airalo Partner API v2
- رمز QR وخطوات التثبيت
- سعر البيع الخاص بكم
المورّد
ما هي Airalo، ولماذا تبيع وكالات السفر شرائح eSIM الخاصة بها
تبيع Airalo شرائح eSIM: باقات SIM رقمية يثبتها المسافر على هاتفه دون إزالة الشريحة الفعلية. بدلاً من شراء شريحة محلية في المطار، يشتري المسافر الإنترنت قبل الرحلة ويثبته خلال دقائق.
من خلال Airalo Partner API، يمكن لشركة السفر بيع هذا المخزون داخل موقعها أو تطبيقها. توفر PHPTRAVELS موصل Airalo ضمن وحدة eSIM، فتصبح eSIM منتجاً إضافياً في السلة نفسها مع الرحلة الجوية والفندق والتوصيل والتأشيرة والجولة.
- الشركة
- Airalo، مزود اتصال eSIM
- التغطية
- أكثر من 200 وجهة، بحسب Airalo
- الباقات
- شرائح eSIM محلية وإقليمية وعالمية
- API
- Partner API v2 · REST · رمز Bearer
- SDKs
- PHP · Node.js · Python
- في PHPTRAVELS
- موصل جاهز في وحدة eSIM
الخطوة 1 · حساب الشريك
قدّموا طلباً للحصول على حساب شريك Airalo
يتطلب الوصول إلى Airalo API اتفاقية شراكة مع Airalo. لا تصدر PHPTRAVELS حسابات أو مفاتيح Airalo: تقدمون الطلب، فتراجع Airalo نشاطكم التجاري وترسل إليكم بيانات الاعتماد.
ما يجب إرساله إلى Airalo
- اسم الشركة والموقع الإلكتروني
- الدولة ونوع النشاط
- حجم مبيعات eSIM المتوقع
- الأسواق والوجهات المستهدفة
- B2C أو B2B أو كلاهما
- أنكم تستخدمون PHPTRAVELS
الخطوة 2 · بيانات الاعتماد
Client ID وClient Secret ورمز الوصول
عند موافقة Airalo على حسابكم، تتلقون Client ID وClient Secret. ترسلهما PHPTRAVELS من خادمكم إلى نقطة الحصول على الرمز، وتستلم رمز وصول Bearer وتستخدمه في كل طلب للباقات والطلبات وشرائح eSIM.
1# Server-side only: the Client Secret never reaches the browser 2curl -X POST "$AIRALO_API/v2/token" \ 3 -H "Accept: application/json" \ 4 -F "client_id=$CLIENT_ID" \ 5 -F "client_secret=$CLIENT_SECRET" \ 6 -F "grant_type=client_credentials" 7 8# → { "data": { "access_token": "eyJ0eXAi…", "expires_in": … } } 9# then: Authorization: Bearer <access_token>
- من الخادم فقط
- يطلب خادم PHPTRAVELS الرمز. لا يصل Client Secret إلى المتصفح أبداً.
- إعادة استخدام الرمز
- يحتفظ الموصل بالرمز حتى انتهاء صلاحيته، فلا يطلب رمزاً جديداً مع كل عملية بحث.
- حافظوا على سرية المفتاح
- لا تضعوا Client Secret أبداً في JavaScript عام أو HTML أو مستودع Git عام أو لقطة شاشة أو منشور في منتدى.
- حساب واحد ووضعان
- تتيح لكم Airalo اختيار Sandbox أو Production في الإعدادات. اختبروا كل شيء في Sandbox أولاً.
مسار Partner API
خمسة استدعاءات Airalo API وراء كل عملية بيع eSIM
من أول سعر يظهر على الشاشة إلى رمز QR في بريد المسافر، يستخدم الموصل الاستدعاءات الخمسة نفسها. يوضح كل منها ما تفعله PHPTRAVELS بالاستجابة.
- 01الحصول على رمزPOST/v2/token
PHPTRAVELSتسجل الدخول باستخدام Client ID وClient Secret وتحفظ رمز Bearer على الخادم.
- 02عرض الباقاتGET/v2/packages
PHPTRAVELSتزامن الباقات المحلية والإقليمية والعالمية مع حجم البيانات والصلاحية والتغطية والسعر الصافي، ثم تطبق سعركم.
- 03إرسال طلبPOST/v2/orders
PHPTRAVELSبعد الدفع، تطلب معرّف الباقة المختارة والكمية، وتحفظ طلب Airalo على الحجز.
- 04قراءة eSIMGET/v2/sims/{sim_iccid}
PHPTRAVELSتقرأ eSIM عبر ICCID: رمز QR ورمز التفعيل وعنوان SM-DP+ ورابط التثبيت المباشر على iOS.
- 05خطوات التثبيتGET/v2/sims/{sim_iccid}/instructions
PHPTRAVELSتجلب تعليمات التثبيت من Airalo لجهاز المسافر ولغته، وتضيفها إلى القسيمة.
الخطوات 3 إلى 5 · لوحة تحكم PHPTRAVELS
اضبطوا Airalo واختبروه وزامنوه من لوحة التحكم
يتم كل شيء في إعدادات وحدة eSIM في لوحة تحكم PHPTRAVELS. تختلف الحقول الدقيقة بحسب إصدار PHPTRAVELS لديكم.
- 01فعّلوا وحدة eSIMافتحوا إعدادات الوحدة وشغّلوا تكامل Airalo eSIM.
- 02أدخلوا بيانات الاعتمادالصقوا Client ID وClient Secret من Airalo، واختاروا Sandbox، ثم احفظوا.
- 03اختبروا الاتصالاستخدموا زر الاختبار. تسجل PHPTRAVELS الدخول إلى Airalo وتعرض حالة الاتصال، أو الخطأ الذي يجب إصلاحه.
- 04زامنوا الباقاتحمّلوا باقات Airalo وتأكدوا من صحة الوجهات والبيانات والصلاحية والأسعار على موقعكم.
البيئة
طلبات تجريبية: لا يتم إصدار eSIM حقيقيةطلبات فعلية: شرائح eSIM حقيقية تُخصم من رصيدكم في Airalo
شاشة توضيحية. قد تختلف الحقول في إصداركم.
الخطوة 5 · باقات eSIM
شرائح eSIM محلية وإقليمية وعالمية من مصدر واحد
تعيد Airalo ثلاثة أنواع من الباقات، لتختاروا eSIM المناسبة لخط سير المسافر. تأتي الباقات والأسعار والتوفر دائماً مباشرة من Airalo.
eSIM محلية
وجهة واحدة، لرحلة إلى دولة واحدة.
مثالeSIM الولايات المتحدة
eSIM إقليمية
عدة دول في منطقة واحدة، لرحلة متعددة الدول.
مثالeSIM أوروبا
eSIM عالمية
دول في عدة مناطق، للرحلات الطويلة أو حول العالم.
مثالeSIM عالمية
- ما يظهر للمسافر
- الوجهة · اسم الباقة · البيانات · الصلاحية · الشبكة · التغطية · السعر
- أحجام البيانات الشائعة: 1 GB و3 GB و5 GB و10 GB، ولكل منها صلاحيتها.
الخطوات 6 إلى 9 · عملية البيع
كيف يشتري المسافر eSIM من Airalo على موقعكم
لا يغادر المسافر موقعكم أبداً. تتولى PHPTRAVELS الحجز والدفع، وتصدر Airalo شريحة eSIM.
- 01المسافر
يفتح قسم eSIM في موقعكم
- 02المسافر
يختار وجهة
- 03PHPTRAVELS
تعرض باقات Airalo بسعركم
- 04المسافر
يختار باقة
- 05المسافر
يحجز ويدفع عبر بوابة الدفع الخاصة بكم
- 06PHPTRAVELS
ترسل الطلب إلى Airalo API
- 07Airalo
تصدر شريحة eSIM
- 08Airalo
تعيد رمز QR وتفاصيل التثبيت
- 09PHPTRAVELS
ترسل eSIM إلى المسافر بالبريد الإلكتروني وفي حسابه
تسليم eSIM
خمس طرق يثبّت بها المسافر شريحة eSIM
تدعم Airalo عدة طرق تثبيت لشركاء API. تضع PHPTRAVELS التفاصيل في قسيمة الحجز وبريد التأكيد وحساب المسافر.
رمز QR
يمسح المسافر رمز QR من إعدادات eSIM في الهاتف.
الإدخال اليدوي
رمز التفعيل وعنوان SM-DP+، للهواتف التي لا تستطيع المسح.
تعليمات Airalo
تعليمات تثبيت خطوة بخطوة من API، لكل جهاز ولغة.
رابط eSIM Cloud أو ملف PDF
رابط مشاركة أو ملف PDF من Airalo يتضمن دليل التثبيت الكامل.
تثبيت مباشر على iOS
رابط تثبيت بلمسة واحدة لهواتف iPhone المتوافقة بإصدارات iOS المدعومة.
بيانات العملاء
اربطوا كل عميل برقم ICCID
تعرّف Airalo كل eSIM برقم ICCID الخاص بها، ولا تخزن في هذه الطريقة البيانات الشخصية لمسافريكم. الحفاظ على الربط بين المسافر وeSIM مسؤوليتكم، وتتولاه PHPTRAVELS ضمن الحجز.
- العميل
- حجز PHPTRAVELS
- طلب Airalo
- ICCID
هذه السلسلة تسهّل الدعم:طلبات الدعممشكلات التثبيتالبحث عن الطلباتسجل الحجوزاتحالة eSIM
الخطوة 7 · سعركم
حددوا سعر البيع واربحوا من كل eSIM
تحتسب Airalo عليكم تكلفة الباقة وفق اتفاقيتكم التجارية. وأنتم تقررون ما يدفعه المسافر، ضمن اتفاقيتكم مع Airalo.
هامش ربح ثابت
المبلغ نفسه يُضاف إلى كل باقة.
هامش ربح بالنسبة المئوية
نسبة من السعر الصافي، فتزيد الأرباح مع الباقات الأكبر.
رسوم خدمة
رسوم منفصلة لكل طلب، تظهر عند الدفع.
ضمن باقة سفر
شريحة eSIM مضمّنة في باقة عطلة أو هدية مع رحلة جوية.
- رحلة جوية إلى دبي
- فندق في دبي
- توصيل من المطار
- eSIM الإمارات
لماذا تضيف الوكالات eSIM
- إيرادات أكبر لكل حجز
- خدمة إضافية يحتاجها كل مسافر دولي تقريباً
- تسليم رقمي فوري، دون مخزون
- يعود المسافرون في رحلتهم التالية
خيار القسائم. تبيع Airalo أيضاً قسائم eSIM: تشترون رموز التفعيل وتوزعونها عبر موقعكم أو تطبيقكم أو نظام CRM أو البريد الإلكتروني. اختاروا الطريقة التي تناسب اتفاقيتكم مع Airalo.
حل المشكلات
عندما لا يعمل شيء ما، تحققوا من هذه أولاً
معظم المشكلات تتعلق ببيانات الاعتماد أو البيئة أو الجهاز. راجعوا القائمة الخاصة بالمشكلة التي تواجهونها.
- فشل اختبار الاتصال
- Client IDClient Secretحساب الشريك نشطوصول API مفعّلSandbox أو Productionاتصال HTTPS صادر من خادمكمSSL
- لا تظهر باقات eSIM
- اتصال APIتوفر الباقاتالبيئةفلاتر الوجهاتاستجابة APIذاكرة التخزين المؤقت في PHPTRAVELS
- فشل الطلب
- باقة غير صالحة أو غير متوفرةرصيد Airaloفشل الرمزخطأ في الشبكةبيئة خاطئةمشكلة مؤقتة لدى Airalo
- رمز QR لا يظهر
- اكتمال الطلبإصدار eSIMحفظ ICCIDإعادة بيانات التثبيتحقول QR في استجابة API
- المسافر لا يستطيع التثبيت
- الهاتف يدعم eSIMالهاتف غير مقفلرمز QR الصحيحeSIM غير مثبتة مسبقاًالتجوال مفعّلAPN عند الحاجة
من يفعل ماذا
PHPTRAVELS تشغّل البرنامج، وAiralo تشغّل شرائح eSIM
Airalo مورّد خارجي. العلاقة التجارية قائمة بين شركة السفر الخاصة بكم وAiralo.
PHPTRAVELS
- موصل Airalo وإعداداته
- صفحات eSIM والبحث والدفع
- هامش ربحكم وبوابات الدفع
- القسائم ورسائل البريد ورقم ICCID في الحجز
- دعم التكامل نفسه
Airalo
- الموافقة على الشراكة وبيانات اعتماد API
- أسعار الباقات والعمولات وقواعد الرصيد
- التغطية والشبكات وتوفر الباقات
- استمرارية API وإصدار eSIM
- اتفاقيتكم التجارية
الأمان
احموا بيانات اعتماد Airalo
- أجروا المصادقة من الخادم فقط، وليس في JavaScript داخل المتصفح
- استخدموا HTTPS لموقعكم ولوحة التحكم
- أمّنوا لوحة التحكم وقيّدوا الوصول إلى الخادم
- حافظوا على تحديث PHPTRAVELS
- راقبوا أي نشاط غير معتاد في API
Airalo
هل تحتاجون إلى مساعدة في التكامل؟
إذا تمت الموافقة على حساب Airalo لكن التكامل يعرض خطأ، افتحوا تذكرة دعم في حساب PHPTRAVELS وأرفقوا: إصدار PHPTRAVELS، ولقطة شاشة لإعدادات Airalo، ونتيجة الاختبار، ومثالاً لوجهة وباقة، ورقم مرجع الحجز، ورسالة الخطأ. لا ترسلوا Client Secret كاملاً أبداً.
اقرأوا: كيف تبيع وكالات السفر شرائح eSIM عبر الإنترنتوثائق Airalo للمطورين
لا. تحتاجون إلى حساب شريك Airalo خاص بكم ومعتمد. توفر PHPTRAVELS البرنامج وموصل Airalo الجاهز.
ترسل Airalo كلاً من Client ID وClient Secret بعد الموافقة على حساب الشريك. لا تصدرها PHPTRAVELS.
يمكن لعملاء PHPTRAVELS مراسلة Rao Suhaib Khan، رئيس الشراكات في Airalo، على rao.khan@airalo.com، مع ذكر أنهم يستخدمون PHPTRAVELS.
نعم. مع حساب شريك Airalo معتمد وموصل PHPTRAVELS، تظهر باقات Airalo المدعومة على موقعكم ويبقى الحجز على موقعكم.
نعم، هامش ربح ثابت أو بنسبة مئوية أو رسوم خدمة، طالما يتوافق مع اتفاقيتكم التجارية مع Airalo.
نعم. لدى Airalo وضع Sandbox لا تُصدر فيه الطلبات التجريبية شرائح eSIM حقيقية. انتقلوا إلى Production فقط بعد أن يعمل المسار كاملاً.
نعم. تقدم Airalo باقات محلية وإقليمية وعالمية، بحسب المخزون المتاح لكل وجهة.
عبر رمز QR، أو بإدخال رمز التفعيل وعنوان SM-DP+، أو باتباع تعليمات Airalo خطوة بخطوة، أو من رابط eSIM Cloud أو ملف PDF، أو برابط تثبيت مباشر على هواتف iPhone المتوافقة.
لا. لدى Airalo حزم SDK للغات PHP وNode.js وPython، لكن الموصل موجود بالفعل في PHPTRAVELS. ما عليكم سوى إضافة بيانات الاعتماد.
واصل الاستكشاف
المزيد عن المنصة
- eSIM
- تكامل Tiqets APIتذاكر معالم Tiqets في محرك الحجز الخاص بك
- تكامل Viator APIجولات وأنشطة Viator في موقع الحجز الخاص بك
- تكامل PKFARE APIبحث وحجز رحلات PKFARE وPNR داخل منصتك
- تكامل RateHawk APIفنادق RateHawk في محرك الحجز الخاص بك، مع موصل جاهز
- واجهات API للسفرواجهات GDS والفنادق والجولات والسيارات والدفع
