カンボジア(+855)の認証コードに最適なルートの選び方

ワンタイム番号と長期利用の回線、カンボジアのテストにはどちらが合いますか?

まず、どちらを使うかを決めましょう。これ以降の判断がすべて変わるからです。OTP Routeには2つのプロダクトがありますが、現在カンボジアに対応しているのはそのうち1つだけです。

• OTP Gateway — 1回の認証のために確保される+855番号です。サービスを選ぶとプラットフォームが番号を割り当て、最初に届いたコードがあなたのものになります。サインアップのQA、1回限りのログイン確認、ローカライズしたオンボーディング画面がカンボジアの入力を受け付けるかの確認に向いています。OTP Gatewayの概要をご覧ください。
• Dedicated Numbers — 保持して更新し続ける回線で、月額$1.95/monthからです。SMS受信、SMS送信、ブラウザ通話に対応しています。セルフサービスで販売しているのは米国とカナダのみです。

セルフサービスで使える長期利用の+855回線はありません。プロジェクトにどうしても必要な場合は、[email protected] まで用途をメールでお知らせください。手配できるかどうかは現地の規制次第なので、約束ではなく問い合わせとして捉えてください。+855のプロジェクトにどちらが合うかは、一時番号と専用番号の比較で解説しています。

カンボジアの認証番号は、どのサービスに使えますか?

カンボジアのライブスナップショットには、1,700を超えるサービスが掲載されています。チームからの要望が特に多いのは、Telegram、Facebook、WhatsApp、Google (Gmail & YouTube)、TikTok、Instagram、LINE、WeChat、Zalo、Viber、ChatGPT (OpenAI)、Shopee、Lazadaなどです。

この顔ぶれは、メッセージングアプリと地域のショッピングプラットフォームが並び立つ市場を反映しています。そのため、東南アジア向けのプロダクトチームは、同じ国番号に対して複数のフローを1回のセッションで確認できます。キャリアのルートが更新されるため、利用可否は一日の中で変わります。APIが固定のカタログではなく、問い合わせた瞬間に注文可能なものを返すのは、そのためです。

カンボジアのOTP APIは、最初から最後までどう動きますか?

すべての呼び出しは、開発者コンソールで発行した or_live_ で始まるBearerキーを付けて、https://otproute.com/api/v1 に送ります。カンボジアの国IDは kh です。

1. GET /api/v1/services と GET /api/v1/countries を取得して、名前とIDを対応づけます。どちらもキャッシュして構いません。
2. GET /api/v1/prices?country=kh&service=<id> で、目的のルートの現在価格と利用可否を確認します。
3. ボディ {"service": "telegram", "country": "kh"} を付けて POST /api/v1/activations で注文を作成します。アクティベーションIDと+855番号が返ってきます。
4. その番号を、自社アプリの認証ステップに入力します。
5. activation.sms_received のWebhookでコードを受け取るか、GET /api/v1/activations/{id} をポーリングします。

Webhookの配信には、X-OTPRoute-Signature: t=<unix>,v1=<hex> が付きます。エンドポイントのシークレットで <t>.<raw body> のHMAC-SHA256を再計算し、定数時間で比較して、古いタイムスタンプは破棄してください。カンボジア向けのテストスイートは、最大10個のキーと5つのWebhookエンドポイントにトラフィックを分散でき、アカウント全体の上限は毎分300リクエストです。ペイロードの詳細はAPIドキュメントにあります。

ダッシュボードからテスト用の+855番号を注文する

サポート担当やプロダクトマネージャーも、コードなしで同じ結果を得られます。

1. サインインして、OTP Gatewayのページを開きます。
2. カンボジアを選び、続けて認証したいサービスを選びます。
3. 画面に表示された価格を確認して、注文を確定します。
4. +855番号を、確認したいアプリまたはウェブサイトにコピーします。
5. アクティベーションカードを見守ります。配信されると、SMSの本文と抽出されたコードがそこに表示されます。

コードが表示される前に気が変わった場合は、アクティベーションをキャンセルすれば、金額はウォレットに戻ります。

+855番号の書式と、クメール語メッセージの扱い方

カンボジアの番号は、国内ではトランクプレフィックスの0を付けて表記します。たとえば携帯電話は 0xx xxx xxx のように表示されます。E.164形式では先頭の0がなくなり、保存される値は +855 に国内番号を続けたものになります。携帯の場合、国内番号はたいてい8桁か9桁です。システムの入口で正規化しましょう。スペース、ハイフン、トランクの0を取り除いてから +855 を付けると、検索、重複排除、Webhookの照合のすべてが、1つの正規の文字列で動きます。

公用語はクメール語で、独自のUnicode文字体系を持ちます。サービスによっては、数字の前後にクメール語の文言を付けてコードを送るものもあれば、英語を既定にするものもあり、同じアプリでもアカウントのロケールに応じて切り替わることがあります。周囲の文面に一致させるのではなく、数字のパターンでコードを抽出し、ログやデータベースがUTF-8を正しく保存できることも確認してください。

+855が使われるのは、タイやベトナムなど近隣国と並べた地域展開、クメール語のローカライズQA、カンボジアのSIMで登録した顧客のサポートといった場面が多いです。

カンボジアのコードが届かないとき、どうなるべきですか?

ルールはシンプルです。課金されるのは、届いたコードの分だけです。20分以内に何も届かなかった場合や、先にキャンセルした場合は、料金の全額が自動的にウォレットへ戻ります。

コードが遅れているときは、次の点を確認してください。

• 1分でキャンセルせず、ウィンドウが終わるまで待ちましょう。メッセージをキューに溜める送信元もあります。
• サービスが仮想番号を受け付けるか確認します。拒否するサービスもあり、返金はまさにそのためにあります。
• 時間をおいて再試行するか、同じテストを別のサービスルートで試してください。
• 短い間隔での再注文は避け、再試行の間隔を空けて、アクティベーションIDをそのつど記録しましょう。

クメール語圏のテスト実行を安定させる、ほかの再試行のコツはOTP配信失敗を減らす方法にまとめています。

カンボジアの認証料金の支払いと、サンドボックスでのテスト

OTP Routeでのルーティングは、月額料金も選ぶべきプランもない、前払い制のUSDウォレット1つで動きます。入金はカードまたはUSDT/USDCのステーブルコインで行え、残高をチャージするたびに、経理にはPDFの請求書がメールで届きます。最新の料金は料金ページをご覧ください。

CIパイプラインを実際の番号につなぐ前に、開発用アカウントをサンドボックスに切り替えるよう依頼してください。シミュレートされた番号とコードが返るため、資金を使わずに連携をエンドツーエンドで試せます。ゲートウェイは自社のプロダクトとアカウントにのみ使用し、各サービスの規約を守ってください。OTP Routeの利用規定(Acceptable Use Policy)も適用されます。

よくある質問

現地のSIMなしで、アプリのカンボジア向けサインアップフローをテストできますか?

はい。OTP Gatewayで+855番号を注文し、サインアップフォームに入力して、ダッシュボードまたはAPIでコードを読み取ります。

APIでの、カンボジアの国IDは何ですか?

GET /api/v1/prices と、POST /api/v1/activations のボディで kh を使います。

カンボジアの番号は、先頭の0を付けたまま保存すべきですか?

いいえ。トランクの0を取り除いた、+855 に国内番号を続けたE.164形式で保存してください。0を付け直すのは、ローカル形式で表示するときだけにします。

+855番号を数か月間保持できますか?

セルフサービスのプロダクトとしてはできません。長期利用のDedicated Numbersは米国とカナダで提供しています。カンボジアについては [email protected] に問い合わせられますが、実現できる保証はありません。

コードはクメール語で届きますか、英語で届きますか?

サービスと、アカウントの言語設定によります。決まった文言に頼らず、数字を解析してください。

SMSが届かなかった場合、課金されますか?

いいえ。20分のウィンドウが閉じるまでにコードが届かなかったアクティベーションは、全額がウォレットに返金されます。

お金をかけずにテストする方法はありますか?

はい。依頼に応じて開発用アカウントをサンドボックスに切り替えられ、シミュレートされた番号とコードが返ります。

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