マレーシア(+60)SMS認証:QAチームとローンチチーム向けガイド

なぜプロダクトチームのテストに+60番号が必要なのですか?

マレーシアは東南アジア展開の最初の拠点になりやすい市場です。ユーザーはマーケットプレイス、配車、メッセージアプリを行き来し、それらの多くが何よりも先に電話番号を確認します。ベルリンやベンガルールにいるQAエンジニアは自国のSIMではこの工程を再現できず、クアラルンプールの同僚にコードを転送してもらう方法も規模に耐えません。OTP Routeなら1コード単位でマレーシアの番号を取得できるため、OTPルーティングの手順を手作業ではなくテストスイートの一部にできます。

マレーシアOTP連携の準備チェックリスト

最初の本番注文の前に、次の項目を確認してください。

1. Developerコンソールで or_live_ キーを作成します。環境ごとに1つずつ発行すると監査がしやすくなります。
2. Webhookエンドポイントを登録して署名検証を実装するか、1分あたり300リクエストを十分下回るポーリング間隔を決めます。
3. 本番番号がまだ必要かどうかを判断します。開発アカウントはリクエストによりサンドボックスに切り替えられ、費用なしでシミュレートされた番号とコードが返ります。
4. 012-345 6789 のような国内表記を +60123456789 に変換する電話番号の正規化処理を追加します。
5. テスト対象のアプリが仮想番号を許可しているか確認します。許可されていない場合はどのルートでも解決できず、何も届かなければウォレットに返金されます。

マレーシアのルートで利用できるサービス

マレーシアはOTP Routeの中でも対応範囲の広い仕向け先のひとつで、現在のスナップショットでは2,700を超えるサービスが利用可能です。地域のコマースが目立ち、Shopee、Lazada、Tokopediaが、Telegram、WeChat、LINEなどのメッセージアプリと並んでいます。WhatsAppのほか、Google(Gmail & YouTube)、Facebook、Instagram、TikTok、Microsoft & Outlook、Amazon、ChatGPT(OpenAI)、Discordといったグローバルなプラットフォームも対象です。

利用可否は常に変動するため、一覧をハードコードせず、実行時に GET /api/v1/services と GET /api/v1/countries を照会してください。マーケットプレイス事業者はマーケットプレイス向けソリューションのページも参照できます。

APIでマレーシアのコードを注文して読み取るには?

すべての呼び出しはBearerキーを付けて https://otproute.com/api/v1 に送ります。マレーシアの国IDは my です。

1. 価格を確認します:GET /api/v1/prices?country=my&service=<id>。
2. アクティベーションを開始します:POST /api/v1/activations に {"service": "<id>", "country": "my"} を送ります。
3. 返された+60番号をアプリの電話番号欄に入力し、SMSを送信させます。
4. Webhookで activation.sms_received を受け取ります。公開エンドポイントがない場合は、一定間隔で GET /api/v1/activations/{id} をポーリングします。
5. activation.expired と activation.cancelled を処理し、テストが失敗ではなく「判定不能」になるようにします。

署名ヘッダーは X-OTPRoute-Signature: t=<unix>,v1=<hex> の形式です。タイムスタンプ、ドット、生のボディに対するHMAC-SHA256を再計算して比較し、古いタイムスタンプは破棄してください。考え方はHMACによるOTP Webhookの保護の記事にまとめてあり、リファレンスへのリンクは開発者ハブにあります。

運用・グロース担当者向けのダッシュボード手順

ローンチチームの全員がコードを書くわけではありません。ダッシュボードでマレーシアを選び、サービスを選択し、表示されたリアルタイム価格を確認して注文を確定します。+60番号をアプリにコピーしてSMSを要求し、アクティベーションカードを待ちます。コードが届き次第、そこに表示されます。気が変わった場合はキャンセルすれば、保留分は残高に戻ります。

マレーシアのコードが表示されない場合

まずは待つことです。アクティベーションは20分間開いたままで、アプリ内の再送だけで解決することもよくあります。それでも届かない場合は次を試してください。

• 時間をおいて再試行するか、テストケースが別の市場を許容するならシンガポールのような近隣ルートに切り替えます。
• マレーシアからのサインアップで、そのサービスが仮想番号を拒否し始めていないか確認します。
• 新しいアクティベーションを短時間に連続して作らないでください。リクエストを無駄にするだけで、結果が変わることはほとんどありません。

空振りに終わったウィンドウには費用がかかりません。アクティベーションが期限切れになるかキャンセルされると、全額がウォレットに戻ります。

番号形式、メッセージの言語、現地事情

マレーシアでは国内でトランクプレフィックス0を使うため、012-345 6789 と書かれた携帯番号は国際表記では +60 12-345 6789 になります。携帯番号は国番号の後に1で始まり、9桁または10桁です。スペース、ハイフン、先頭の0を取り除いて、E.164形式で保存してください。

マレー語が国語で、ビジネスでは英語が広く使われ、中国語系やタミル語系の大きなコミュニティもアプリのローカライズに影響します。認証SMSは英語またはマレー語で届くことが多いため、文言ではなく数字でコードを判別してください。この言語の混在こそ、多くのチームがマレーシアの番号でローカライズQAを行う理由です。

課金と長期利用の番号

すべてを1つのプリペイドUSDウォレットでまかない、月額料金やプランはありません。カードまたはUSDT/USDCでチャージでき、チャージごとにPDFの請求書がメールで届きます。詳細は料金をご覧ください。

マレーシアではセルフサービスの長期番号は提供していません。Dedicated Numbersは米国とカナダのみで、$1.95/月からです。+60の長期回線が必要な場合は [email protected] までご連絡ください。提供可否は現地の規制によって異なり、保証はできません。

よくある質問

APIでマレーシアのSMS OTPを受信できますか?

はい。OTP RouteのAPIは国ID my で+60のアクティベーションを作成し、コードをWebhookまたはポーリングで届けます。

マレーシアの携帯番号をE.164で書くにはどうしますか?

国内表記の先頭の0を外して+60を付けます。012-345 6789は+60123456789になります。

マレーシアの番号でShopeeやLazadaのサインアップをテストできますか?

どちらも現在のマレーシアのスナップショットに含まれていますが、利用可否は変動します。まずリアルタイムのサービス一覧を確認し、各プラットフォームの規約に従ってください。

マレーシアの認証コードはいくらですか?

マレーシアのルートは1コード$0.20から。サービスごとの具体的な金額は、注文を確定する前にダッシュボードに表示されます。

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

いいえ。20分のウィンドウ内にコードが届かない場合、またはキャンセルした場合は、全額がウォレットに戻ります。

ウォレットに入金する前に、マレーシア向け連携の動作確認はできますか?

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

マレーシアの番号を数か月間保持できますか?

セルフサービスでは提供していません。長期のDedicated Numbersは米国とカナダのみです。マレーシアについては [email protected] にお問い合わせください。

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