دموی زنده

یکپارچه‌سازی eSIM API

یکپارچه‌سازی Airalo API: با هر سفر eSIM بفروشید

حساب شریک Airalo خود را به PHPTRAVELS متصل کنید و eSIM‌های محلی، منطقه‌ای و جهانی را در وب‌سایت خودتان، در کنار پرواز، هتل و تور بفروشید. کانکتور آماده است: Client ID و Client Secret را وارد کنید، در Sandbox تست کنید، بسته‌ها را همگام کنید، قیمت خود را تعیین کنید و فعال شوید.

  • کانکتور آماده Airalo
  • Airalo Partner API v2
  • کد QR و مراحل نصب
  • قیمت فروش دلخواه شما

تأمین‌کننده

Airalo چیست و چرا آژانس‌های مسافرتی eSIM‌های آن را می‌فروشند

Airalo فروشنده eSIM است: بسته‌های سیم‌کارت دیجیتال که مسافر بدون خارج کردن سیم‌کارت فیزیکی روی گوشی نصب می‌کند. مسافر به جای خرید سیم‌کارت محلی در فرودگاه، اینترنت را پیش از سفر می‌خرد و در چند دقیقه نصب می‌کند.

از طریق Airalo Partner API، یک کسب‌وکار سفر می‌تواند این موجودی را در وب‌سایت یا اپلیکیشن خود بفروشد. PHPTRAVELS یک کانکتور Airalo در ماژول eSIM ارائه می‌دهد، پس eSIM یک محصول دیگر در همان سبد خرید کنار پرواز، هتل، ترانسفر، ویزا یا تور می‌شود.

مرتبط:eSIMAPIهای سفریکپارچه‌سازی API سفر

مشخصات تأمین‌کننده
شرکت
Airalo، ارائه‌دهنده اتصال eSIM
پوشش
بیش از 200 مقصد، به گفته Airalo
بسته‌ها
eSIM‌های محلی، منطقه‌ای و جهانی
API
Partner API v2 · REST · توکن Bearer
SDKها
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 هرگز به مرورگر نمی‌رسد.
استفاده مجدد از توکن
کانکتور توکن را تا زمان انقضا نگه می‌دارد، پس در هر جستجو توکن جدید درخواست نمی‌کند.
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}

    PHPTRAVELSeSIM را با 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 برای PHP، Node.js و Python SDK دارد، اما کانکتور از قبل در PHPTRAVELS وجود دارد. فقط اطلاعات احراز هویت خود را وارد می‌کنید.

بیشتر بدانید

بیشتر درباره پلتفرم