API・Webhook・ダッシュボードで foodpanda の SMS コードを取得する

foodpanda のコードを取得する API 呼び出しは？

foodpanda 認証コード API の流れでは、サービス ID foodpanda を使い、https://otproute.com/api/v1 に対して 5 つの呼び出しを行います。いずれも or_live_ で始まる Bearer キーで認証します。

1. GET /api/v1/countries で国 ID を取得します。結果はキャッシュしておきます。
2. GET /api/v1/prices?country=<id>&service=foodpanda で現在の価格と、その市場が今この時点で利用可能かどうかを確認します。
3. POST /api/v1/activations に {"service": "foodpanda", "country": "<id>"} を送ると、注文が作成され、アクティベーション ID と電話番号が返ります。
4. テストで、その番号を対象の foodpanda 画面に入力し、Webhook または GET /api/v1/activations/{id} でコードを取得します。
5. テストで不要になった注文は POST /api/v1/activations/{id}/cancel で閉じます。

セットアップ段階で GET /api/v1/balance も加えておくと、ウォレットが空になったときにテストスイートをきれいに停止できます。キーは開発者コンソールで発行でき、1 アカウントあたり最大 10 個、上限は 1 分あたり 300 リクエストです。リクエストとエラーの形式は開発者向けドキュメントにまとめています。

Webhook ハンドラーはどう書くべきか？

複数のテストを同時に走らせるなら、プッシュ配信のほうがすっきりします。許可されている 5 つのエンドポイントのうち 1 つをテストハーネス内のルートに向け、foodpanda の注文について activation.sms_received、activation.expired、activation.cancelled を購読します。

すべての配信には X-OTPRoute-Signature: t=<unix>,v1=<hex> が含まれます。エンドポイントのシークレットで <t>.<raw body> の HMAC-SHA256 を計算し、v1 と定数時間で比較し、タイムスタンプが古すぎるリクエストは拒否してください。この処理は、JSON のパースで内容が変わってしまう前に、生のバイト列に対して行います。

ハンドラーは冪等にします。再送で同じイベントが 2 回届くことがあるため、アクティベーション ID をキーにして重複を無視してください。応答は素早く返し、コードはテストが待っている処理へ渡します。簡単なスクリプトなら、数秒おきにアクティベーションのエンドポイントをポーリングする方法でも問題ありません。細かいケースは HMAC Webhook ガイドで解説しています。

foodpanda は何のために電話番号を確認するのか？

foodpanda は、南アジアと東南アジアで特によく知られるフード・食料品デリバリープラットフォームです。多くのデリバリーアプリと同様に、アカウントを携帯番号に紐づけます。番号はたいてい、サインアップ時にワンタイムの SMS コードで確認され、新しい端末でのログイン時に再度確認されることもあり、配達員やサポートが注文について顧客に連絡する手段にもなります。

このプラットフォームの周辺で働くパートナーチーム、エージェンシー、開発者にとって、foodpanda の OTP を受け取る手順は多くの実際の場面に含まれます。新規顧客のオンボーディング、ローカライズされたサインアップ画面のテスト、ユーザーから報告されたログイン問題の再現などです。テストごとに管理できる foodpanda 用の電話番号があれば、同僚の個人 SIM を借りる必要はなくなります。

foodpanda の番号はどの国から調達できるか？

foodpanda のルートは 198 か国で利用できます。例として、パキスタン、バングラデシュ、マレーシア、フィリピン、台湾、シンガポール、香港、タイ、カンボジア、ラオス、ミャンマー、ドイツ、英国、米国などがあります。

国の選択は見た目だけの問題ではありません。デリバリーアプリは市場ごとにローカライズされるため、バングラデシュのサインアップ画面のテストにはバングラデシュの番号を、クアラルンプールで注文するためのアカウントにはマレーシアの番号を使うのが適切です。国が合っていないと、番号が拒否されたり、無関係な地域のフローに進んだりすることがあります。国別の提供状況は一日の中で変動するため、基準となるのは価格エンドポイントです。市場の選び方とフォールバックの方法は国別ルーティングガイドで説明しています。

開発者でなくてもダッシュボードから実行できるか？

はい。ランチを注文するのと同じくらいの手数で済みます。

1. OTP Gateway を開き、サービスに foodpanda、国を選択します。
2. 表示された価格を確認し、注文を確定します。
3. テストしている foodpanda のアプリまたはウェブサイトに番号をコピーします。
4. アクティベーションカードを見ていると、SMS が届いた時点でコードが表示されます。

有効時間は 20 分です。foodpanda からコードが送られてこない場合やキャンセルした場合は、料金が自動的にウォレットへ戻るため、実際に届いたコードの分だけお支払いいただきます。

foodpanda のコードが届かないのはなぜか？

取りこぼしのほぼすべては、いくつかの原因でカバーできます。foodpanda は多くの消費者向けアプリと同様に、市場や操作によっては仮想番号を受け付けないことがあります。1 台の端末、IP、アカウントがコードを要求できる頻度を制限している場合もあります。また、個々のルートが混雑する時間帯もあります。

テスト用に foodpanda の SMS 認証を行うときの有効な習慣は次のとおりです。

• キャンセルする前に、有効時間をいっぱいまで待ちます。
• 短い間隔で再注文を繰り返さず、再試行の間隔をあけます。
• テストケースが許せば、別の国のルートを試します。
• パイプラインを構築している間は、開発用アカウントのサンドボックスモードを使い、配管のバグに実際の注文を費やさないようにします。

どのルートでも、サービスに番号を受け付けさせることはできません。自動返金は、まさにそうした状況のためにあります。

専用番号が適しているのはどんなときか。基本ルールは？

ワンタイムの Gateway 番号では、後から 2 つ目のコードを受け取ることはできません。ステージングや QA のアカウントが数週間後に再度ログインする必要があるなら、foodpanda 用に保持できる仮想番号のほうが向いています。専用の仮想番号（Dedicated Virtual Numbers）は米国とカナダで月額 $1.95 から利用でき、受信 SMS はダッシュボードと Webhook で確認できます。それ以外の国にはセルフサービスの長期番号はありません。[email protected] にメールでお問い合わせください。詳細は仮想番号をご覧ください。

OTP Route は、自社のプロダクトと正当なアカウントにのみご利用ください。アカウントは実在する個人または事業者 1 つにつき 1 つとし、常に foodpanda の規約と OTP Route の利用規約（Acceptable Use Policy）の範囲内で使ってください。foodpanda はその所有者の商標であり、OTP Route は foodpanda と提携していません。資金はプリペイド式の USD ウォレットで、月額料金はなく、カードまたは USDT/USDC でチャージでき、チャージごとに PDF の請求書が発行されます。

よくある質問

OTP Route の API で foodpanda のサービス ID は何ですか？

foodpanda です。価格の問い合わせとアクティベーションのリクエストで、国 ID と組み合わせて使います。

CI で foodpanda のサインアップテストを自動化できますか？

はい。環境ごとにキーを作成し、API から注文して、activation.sms_received の Webhook を待つか、アクティベーションをポーリングします。

foodpanda のテスト番号はどの国のものにすべきですか？

アカウントの対象となる市場の番号です。foodpanda は国ごとにローカライズされているため、市場に合わせると番号の拒否や誤った地域のフローを避けられます。

foodpanda がコードを送ってこなかった場合、料金はかかりますか？

いいえ。20 分以内に SMS が届かなかった、またはキャンセルした foodpanda の注文は、ウォレットに全額返金されます。

foodpanda は OTP Route のすべての番号を受け付けますか？

必ずしもそうではありません。サービスによっては仮想番号を拒否するため、受け付けられるかどうかは国や操作によって異なります。

同じ foodpanda 用の電話番号で、来月もう一度コードを受け取れますか？

Gateway の番号は 1 回の認証専用です。繰り返しログインする場合は、米国またはカナダの専用番号をご利用ください。

Webhook が本当に OTP Route から届いたものだと確認するには？

エンドポイントのシークレットでタイムスタンプと生の本文の HMAC-SHA256 を再計算し、署名ヘッダーと比較して、古いタイムスタンプは拒否します。

サービス名はそれぞれの所有者の商標です。OTP Route はこれらの企業と提携していません。番号は合法的にご利用いただき、各サービスの利用規約および当社の利用規定に従ってください。