عرض تجريبي مباشر

تكامل 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 منتجاً إضافياً في السلة نفسها مع الرحلة الجوية والفندق والتوصيل والتأشيرة والجولة.

ذو صلة:eSIMواجهات API للسفرتكامل API السفر

بطاقة معلومات المورّد
الشركة
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>
client_credentialsPartner API v2Bearer token · Sandbox → Production
من الخادم فقط
يطلب خادم PHPTRAVELS الرمز. لا يصل Client Secret إلى المتصفح أبداً.
إعادة استخدام الرمز
يحتفظ الموصل بالرمز حتى انتهاء صلاحيته، فلا يطلب رمزاً جديداً مع كل عملية بحث.
حافظوا على سرية المفتاح
لا تضعوا Client Secret أبداً في JavaScript عام أو HTML أو مستودع Git عام أو لقطة شاشة أو منشور في منتدى.
حساب واحد ووضعان
تتيح لكم Airalo اختيار Sandbox أو Production في الإعدادات. اختبروا كل شيء في Sandbox أولاً.

مسار Partner API

خمسة استدعاءات Airalo API وراء كل عملية بيع eSIM

من أول سعر يظهر على الشاشة إلى رمز QR في بريد المسافر، يستخدم الموصل الاستدعاءات الخمسة نفسها. يوضح كل منها ما تفعله PHPTRAVELS بالاستجابة.

  1. 01الحصول على رمزPOST/v2/token

    PHPTRAVELSتسجل الدخول باستخدام Client ID وClient Secret وتحفظ رمز Bearer على الخادم.

  2. 02عرض الباقاتGET/v2/packages

    PHPTRAVELSتزامن الباقات المحلية والإقليمية والعالمية مع حجم البيانات والصلاحية والتغطية والسعر الصافي، ثم تطبق سعركم.

  3. 03إرسال طلبPOST/v2/orders

    PHPTRAVELSبعد الدفع، تطلب معرّف الباقة المختارة والكمية، وتحفظ طلب Airalo على الحجز.

  4. 04قراءة eSIMGET/v2/sims/{sim_iccid}

    PHPTRAVELSتقرأ eSIM عبر ICCID: رمز QR ورمز التفعيل وعنوان SM-DP+ ورابط التثبيت المباشر على iOS.

  5. 05خطوات التثبيتGET/v2/sims/{sim_iccid}/instructions

    PHPTRAVELSتجلب تعليمات التثبيت من Airalo لجهاز المسافر ولغته، وتضيفها إلى القسيمة.

الخطوات 3 إلى 5 · لوحة تحكم PHPTRAVELS

اضبطوا Airalo واختبروه وزامنوه من لوحة التحكم

يتم كل شيء في إعدادات وحدة eSIM في لوحة تحكم PHPTRAVELS. تختلف الحقول الدقيقة بحسب إصدار PHPTRAVELS لديكم.

  1. 01فعّلوا وحدة eSIMافتحوا إعدادات الوحدة وشغّلوا تكامل Airalo eSIM.
  2. 02أدخلوا بيانات الاعتمادالصقوا Client ID وClient Secret من Airalo، واختاروا Sandbox، ثم احفظوا.
  3. 03اختبروا الاتصالاستخدموا زر الاختبار. تسجل PHPTRAVELS الدخول إلى Airalo وتعرض حالة الاتصال، أو الخطأ الذي يجب إصلاحه.
  4. 04زامنوا الباقاتحمّلوا باقات Airalo وتأكدوا من صحة الوجهات والبيانات والصلاحية والأسعار على موقعكم.
وحدة eSIM · AiraloAiralo

البيئة

طلبات تجريبية: لا يتم إصدار eSIM حقيقيةطلبات فعلية: شرائح eSIM حقيقية تُخصم من رصيدكم في Airalo

Client ID7f3c…a91e
Client Secret••••••••••••••••
هامش الربح15% على السعر الصافي
الحالةمتصل

شاشة توضيحية. قد تختلف الحقول في إصداركم.

الخطوة 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.

  1. 01المسافر

    يفتح قسم eSIM في موقعكم

  2. 02المسافر

    يختار وجهة

  3. 03PHPTRAVELS

    تعرض باقات Airalo بسعركم

  4. 04المسافر

    يختار باقة

  5. 05المسافر

    يحجز ويدفع عبر بوابة الدفع الخاصة بكم

  6. 06PHPTRAVELS

    ترسل الطلب إلى Airalo API

  7. 07Airalo

    تصدر شريحة eSIM

  8. 08Airalo

    تعيد رمز QR وتفاصيل التثبيت

  9. 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 ضمن الحجز.

  1. العميل
  2. حجز PHPTRAVELS
  3. طلب Airalo
  4. ICCID

هذه السلسلة تسهّل الدعم:طلبات الدعممشكلات التثبيتالبحث عن الطلباتسجل الحجوزاتحالة eSIM

الخطوة 7 · سعركم

حددوا سعر البيع واربحوا من كل eSIM

تحتسب Airalo عليكم تكلفة الباقة وفق اتفاقيتكم التجارية. وأنتم تقررون ما يدفعه المسافر، ضمن اتفاقيتكم مع Airalo.

  • هامش ربح ثابت

    المبلغ نفسه يُضاف إلى كل باقة.

  • هامش ربح بالنسبة المئوية

    نسبة من السعر الصافي، فتزيد الأرباح مع الباقات الأكبر.

  • رسوم خدمة

    رسوم منفصلة لكل طلب، تظهر عند الدفع.

  • ضمن باقة سفر

    شريحة eSIM مضمّنة في باقة عطلة أو هدية مع رحلة جوية.

مثال على البيع المتقاطع
  1. رحلة جوية إلى دبي
  2. فندق في دبي
  3. توصيل من المطار
  4. 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 API: أسئلة تطرحها الوكالات

تحدّث مع المبيعات

لا. تحتاجون إلى حساب شريك 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. ما عليكم سوى إضافة بيانات الاعتماد.