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は航空券、ホテル、送迎、ビザ、ツアーと同じカートに入る商品のひとつになります。
- 会社
- 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>
- サーバー側のみで処理
- トークンはPHPTRAVELSのサーバーが取得します。Client Secretがブラウザに渡ることはありません。
- トークンの再利用
- コネクターは有効期限までトークンを保持します。検索のたびに新しいトークンを取得することはありません。
- シークレットを公開しない
- Client Secretを公開JavaScript、HTML、公開Gitリポジトリ、スクリーンショット、フォーラムの投稿に含めないでください。
- 1つのアカウントで2つのモード
- Airaloでは設定でSandboxとProductionを選択できます。まずSandboxですべてをテストしてください。
Partner APIの流れ
eSIM販売を支える5つのAiralo API呼び出し
画面に最初の価格が表示されてから、旅行者の受信箱にQRコードが届くまで、コネクターは同じ5つの呼び出しを使います。それぞれについて、PHPTRAVELSが応答をどう処理するかを示します。
- 01トークンを取得POST/v2/token
PHPTRAVELSClient IDとClient Secretでサインインし、Bearerトークンをサーバーに保存します。
- 02パッケージを一覧表示GET/v2/packages
PHPTRAVELSローカル、リージョナル、グローバルのパッケージを、データ量、有効期間、対応エリア、仕入れ価格とともに同期し、お客様の価格を適用します。
- 03注文を送信POST/v2/orders
PHPTRAVELS決済完了後、選択されたパッケージIDと数量で注文し、Airaloの注文情報を予約に保存します。
- 04eSIMを取得GET/v2/sims/{sim_iccid}
PHPTRAVELSICCIDでeSIMを読み込みます。QRコード、アクティベーションコード、SM-DP+アドレス、iOS直接インストールリンクを取得します。
- 05インストール手順GET/v2/sims/{sim_iccid}/instructions
PHPTRAVELS旅行者の端末と言語に合わせたAiraloのインストール手順を取得し、バウチャーに追加します。
ステップ3〜5 · PHPTRAVELS管理画面
管理画面でAiraloを設定、テスト、同期する
すべての操作は、PHPTRAVELS管理画面のeSIMモジュール設定で行います。具体的な項目はPHPTRAVELSのバージョンによって異なります。
- 01eSIMモジュールを有効にするモジュール設定を開き、Airalo eSIM連携をオンにします。
- 02認証情報を入力するAiraloから届いたClient IDとClient Secretを貼り付け、Sandboxを選択して保存します。
- 03接続をテストするテストボタンを使います。PHPTRAVELSがAiraloにサインインし、接続済みのステータス、または修正すべきエラーを表示します。
- 04パッケージを同期するAiraloのパッケージを読み込み、渡航先、データ量、有効期間、価格がサイト上で正しく表示されているか確認します。
環境
テスト注文:実際のeSIMは発行されません本番注文:実際のeSIMが発行され、Airaloの残高から引き落とされます
サンプル画面です。項目はバージョンによって異なる場合があります。
ステップ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が行います。
- 01旅行者
サイトのeSIMページを開く
- 02旅行者
渡航先を選ぶ
- 03PHPTRAVELS
お客様の価格でAiraloのパッケージを表示
- 04旅行者
パッケージを選ぶ
- 05旅行者
お客様の決済ゲートウェイで予約と支払いを行う
- 06PHPTRAVELS
注文をAiralo APIに送信
- 07Airalo
eSIMを発行
- 08Airalo
QRコードとインストール情報を返す
- 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はこれを予約上で行います。
- 顧客
- PHPTRAVELSの予約
- Airaloの注文
- ICCID
この紐付けによりサポートが簡単になります:サポート依頼インストールの問題注文の照会予約履歴eSIMのステータス
ステップ7 · 販売価格
販売価格を設定し、eSIMごとに収益を得る
Airaloは契約に基づくパッケージ料金をお客様に請求します。旅行者が支払う金額は、Airaloとの契約の範囲内でお客様が決定します。
固定マークアップ
すべてのパッケージに同じ金額を上乗せします。
パーセント指定のマークアップ
仕入れ価格に対する割合で設定します。大きなプランほど利益が増えます。
サービス料
注文ごとに別途料金を設定し、決済時に表示します。
パッケージに含める
ツアーパッケージにeSIMを含めたり、航空券の特典として提供したりします。
- ドバイ行きの航空券
- ドバイのホテル
- 空港送迎
- 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の全文は絶対に含めないでください。
いいえ。承認済みの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に搭載されています。認証情報を追加するだけです。
