ライブデモ

eSIM API連携

Airalo API連携:すべての旅にeSIMを

AiraloのパートナーアカウントをPHPTRAVELSに接続し、ローカル、リージョナル、グローバルのeSIMを自社サイトで販売できます。航空券、ホテル、ツアーと並べて提供可能です。コネクターは導入済みです。Client IDとClient Secretを入力し、Sandboxでテストし、パッケージを同期して価格を設定すれば、すぐに公開できます。

  • 導入済みのAiraloコネクター
  • Airalo Partner API v2
  • QRコードとインストール手順
  • 独自の販売価格

サプライヤー

Airaloとは何か、そして旅行会社がそのeSIMを販売する理由

AiraloはeSIMを販売しています。eSIMとは、物理SIMを取り外さずにスマートフォンにインストールできるデジタルSIMパッケージです。旅行者は空港で現地SIMを買う代わりに、出発前にデータ通信を購入し、数分でインストールできます。

Airalo Partner APIを利用すると、旅行事業者はこの在庫を自社のウェブサイトやアプリで販売できます。PHPTRAVELSはeSIMモジュールにAiraloコネクターを搭載しています。そのため、eSIMは航空券、ホテル、送迎、ビザ、ツアーと同じカートに入る商品のひとつになります。

関連情報:eSIM旅行API旅行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がブラウザに渡ることはありません。
トークンの再利用
コネクターは有効期限までトークンを保持します。検索のたびに新しいトークンを取得することはありません。
シークレットを公開しない
Client Secretを公開JavaScript、HTML、公開Gitリポジトリ、スクリーンショット、フォーラムの投稿に含めないでください。
1つのアカウントで2つのモード
Airaloでは設定でSandboxとProductionを選択できます。まずSandboxですべてをテストしてください。

Partner APIの流れ

eSIM販売を支える5つのAiralo API呼び出し

画面に最初の価格が表示されてから、旅行者の受信箱にQRコードが届くまで、コネクターは同じ5つの呼び出しを使います。それぞれについて、PHPTRAVELSが応答をどう処理するかを示します。

  1. 01トークンを取得POST/v2/token

    PHPTRAVELSClient IDとClient Secretでサインインし、Bearerトークンをサーバーに保存します。

  2. 02パッケージを一覧表示GET/v2/packages

    PHPTRAVELSローカル、リージョナル、グローバルのパッケージを、データ量、有効期間、対応エリア、仕入れ価格とともに同期し、お客様の価格を適用します。

  3. 03注文を送信POST/v2/orders

    PHPTRAVELS決済完了後、選択されたパッケージIDと数量で注文し、Airaloの注文情報を予約に保存します。

  4. 04eSIMを取得GET/v2/sims/{sim_iccid}

    PHPTRAVELSICCIDでeSIMを読み込みます。QRコード、アクティベーションコード、SM-DP+アドレス、iOS直接インストールリンクを取得します。

  5. 05インストール手順GET/v2/sims/{sim_iccid}/instructions

    PHPTRAVELS旅行者の端末と言語に合わせたAiraloのインストール手順を取得し、バウチャーに追加します。

ステップ3〜5 · PHPTRAVELS管理画面

管理画面でAiraloを設定、テスト、同期する

すべての操作は、PHPTRAVELS管理画面のeSIMモジュール設定で行います。具体的な項目はPHPTRAVELSのバージョンによって異なります。

  1. 01eSIMモジュールを有効にするモジュール設定を開き、Airalo eSIM連携をオンにします。
  2. 02認証情報を入力するAiraloから届いたClient IDとClient Secretを貼り付け、Sandboxを選択して保存します。
  3. 03接続をテストするテストボタンを使います。PHPTRAVELSがAiraloにサインインし、接続済みのステータス、または修正すべきエラーを表示します。
  4. 04パッケージを同期するAiraloのパッケージを読み込み、渡航先、データ量、有効期間、価格がサイト上で正しく表示されているか確認します。
eSIMモジュール · AiraloAiralo

環境

テスト注文:実際のeSIMは発行されません本番注文:実際のeSIMが発行され、Airaloの残高から引き落とされます

Client ID7f3c…a91e
Client Secret••••••••••••••••
マークアップ仕入れ価格に15%
ステータス接続済み

サンプル画面です。項目はバージョンによって異なる場合があります。

ステップ5 · eSIMパッケージ

ローカル、リージョナル、グローバルeSIMを1つのフィードで

Airaloは3種類のパッケージを提供しているため、旅行者の旅程に合ったeSIMを選べます。パッケージ、価格、在庫状況は常にAiraloからリアルタイムで取得されます。

  • ローカルeSIM

    1つの渡航先向け。1か国だけを訪れる旅に。

    例アメリカ eSIM

  • リージョナルeSIM

    1つの地域内の複数国に対応。周遊旅行に。

    例ヨーロッパ eSIM

  • グローバルeSIM

    複数の地域にまたがる国々に対応。長期旅行や世界一周に。

    例グローバル eSIM

旅行者に表示される情報
渡航先 · パッケージ名 · データ量 · 有効期間 · 通信網 · 対応エリア · 価格
主なデータ容量:1 GB、3 GB、5 GB、10 GB。それぞれ有効期間が設定されています。

ステップ6〜9 · 販売

旅行者がお客様のサイトでAiraloのeSIMを購入する流れ

旅行者がサイトを離れることはありません。予約と決済はPHPTRAVELSが行い、eSIMの発行はAiraloが行います。

  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をインストールする5つの方法

AiraloはAPIパートナー向けに複数のインストール方法を用意しています。PHPTRAVELSは、その情報を予約バウチャー、確認メール、旅行者のアカウントに記載します。

  • QRコード

    旅行者はスマートフォンのeSIM設定からQRコードを読み取ります。

  • 手動入力

    QRコードを読み取れない端末向けに、アクティベーションコードとSM-DP+アドレスを提供します。

  • Airaloの手順

    APIから取得した、端末と言語ごとのステップごとのインストール手順です。

  • eSIM CloudリンクまたはPDF

    Airaloが提供する共有リンクまたはPDFで、インストールガイド全体を確認できます。

  • iOS直接インストール

    対応するiOSバージョンの対応iPhoneで、ワンタップでインストールできるリンクです。

顧客データ

すべての顧客をICCIDに紐付ける

AiraloはeSIMをICCIDで識別し、この方式では旅行者の個人データを保存しません。旅行者とeSIMの紐付けを管理するのはお客様の役割です。PHPTRAVELSはこれを予約上で行います。

  1. 顧客
  2. PHPTRAVELSの予約
  3. Airaloの注文
  4. ICCID

この紐付けによりサポートが簡単になります:サポート依頼インストールの問題注文の照会予約履歴eSIMのステータス

ステップ7 · 販売価格

販売価格を設定し、eSIMごとに収益を得る

Airaloは契約に基づくパッケージ料金をお客様に請求します。旅行者が支払う金額は、Airaloとの契約の範囲内でお客様が決定します。

  • 固定マークアップ

    すべてのパッケージに同じ金額を上乗せします。

  • パーセント指定のマークアップ

    仕入れ価格に対する割合で設定します。大きなプランほど利益が増えます。

  • サービス料

    注文ごとに別途料金を設定し、決済時に表示します。

  • パッケージに含める

    ツアーパッケージにeSIMを含めたり、航空券の特典として提供したりします。

クロスセルの例
  1. ドバイ行きの航空券
  2. ドバイのホテル
  3. 空港送迎
  4. UAE eSIM

旅行会社がeSIMを取り扱う理由

  • 予約1件あたりの収益が増える
  • 海外旅行者のほぼ全員が必要とする付帯商品
  • デジタルで即時提供、在庫不要
  • 旅行者が次の旅でも戻ってくる

バウチャー方式. AiraloはeSIMバウチャーも販売しています。アクティベーションコードを購入し、ウェブサイト、アプリ、CRM、メールで配布できます。Airaloとの契約に合った方法を選んでください。

トラブルシューティング

うまく動かないときは、まずここを確認

問題の多くは、認証情報、環境、端末のいずれかが原因です。発生している問題に応じて、上から順に確認してください。

接続テストに失敗する
Client IDClient Secretパートナーアカウントが有効APIアクセスが有効SandboxかProductionかサーバーからの外向きHTTPS通信SSL
eSIMパッケージが表示されない
API接続パッケージの在庫状況環境渡航先フィルターAPIレスポンスPHPTRAVELSのキャッシュ
注文に失敗する
無効または販売停止中のパッケージAiraloの残高トークンの取得失敗ネットワークエラー環境の誤りAiralo側の一時的な問題
QRコードが表示されない
注文が完了しているeSIMが発行済みICCIDが保存済みインストール情報が返されているAPIレスポンス内のQR項目
旅行者がインストールできない
端末がeSIMに対応SIMロック解除済み正しいQRコードeSIMが未インストールローミングがオン必要に応じてAPN

役割分担

ソフトウェアはPHPTRAVELS、eSIMはAiralo

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のお客様は、Airaloのパートナーシップ責任者であるRao Suhaib Khan(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に搭載されています。認証情報を追加するだけです。