マカオ+853認証番号によるテストと運用

マカオの番号は、香港や中国本土の番号とどう違うのか？

マカオには独自の国番号+853があり、香港の+852や中国本土の+86とは別です。当たり前のようですが、3つを1つの旗にまとめる電話番号の入力欄や、ブラウザのロケールから国番号を推測する実装は、この地域でサインアップが失敗する一般的な原因になっています。

現地の番号は8桁でトランクプレフィックスはなく、携帯番号は6で始まります。E.164では、マカオの携帯は+853にその8桁を続けた形です。入力を正規化する際は、スペースとハイフンを取り除き、先頭の853は許容し、隣接地域の桁数に当たる番号は拒否してください。+853の欄に貼り付けられた11桁の中国本土の携帯番号は、どこにも届かないSMSを黙って送るのではなく、検証で失敗させるべきです。

より広い地域にも対応する場合は、カタログでこのルートの隣に香港と台湾のルートがあります。

+853の認証テキストは何語で届くのか？

中国語とポルトガル語がどちらも公用語で、日常の話し言葉は広東語、ビジネスや接客では英語もよく使われます。実際には、マカオの番号に届くコードは、送信元とアプリのロケールに応じて、繁体字の中国語、英語、まれにポルトガル語で書かれていることがあります。

QAでは、次の2点を意味します。1つ目は、抽出ロジックがASCIIの文章だけでなく、中国語の文章の中からも数字を見つけられること。2つ目は、自社製品がマカオのユーザーにコードを送る場合、対応する各言語でメッセージをプレビューすること。中国語の文字を含むメッセージはUnicodeエンコードを使い、SMS 1通に収まる文字数が少なくなるためです。

チームにマカオの認証番号が必要なのはなぜか？

マカオの経済は、観光、ホスピタリティ、アジア各地からの訪問者を迎えるサービスに大きく依存しており、現地で使われるアプリの多くは、純粋にローカルなものではなく、地域向けか国際的なものです。事業者が+853番号でテストする典型的な理由は次のとおりです。

• 旅行、予約、ロイヤルティの製品で、訪問者だけでなくマカオの居住者もサインアップできることを確認する。
• メッセージングやマーケットプレイスのアプリで、繁体字中国語のローカライズをエンドツーエンドで確認する。
• マカオの店舗の業務用プロフィールを管理し、社員の個人SIMを使いたくない運用チーム。
• 香港や台湾と並べて、この地域を地域別のテストマトリクスに加えるQAグループ。

アカウント管理のケースをより詳しく扱っているのが、運用チームのページです。

OTP Gatewayでマカオの番号に届くサービスは？

現在、マカオのルートでは1,600を超えるサービスが利用できます。アジアのこの地域で重要なものには、WeChat、WhatsApp、LINE、KakaoTalk、Telegram、Google（Gmail＆YouTube）、Facebook、Instagram、Microsoft＆Outlook、Amazon、AliExpress、Airbnb、Netflix、Discordがあります。

内訳は一日の中で変わるため、自動実行では保存した一覧に頼らず、moで現在使えるものをAPIに問い合わせてください。

APIでマカオのコードを受信するには？

すべてhttps://otproute.com/api/v1の配下にあり、プレフィックスがor_live_のBearerキーで認証します。国IDにはmoを使います。

1. サービスIDは、GET /api/v1/servicesで一度だけ調べます。
2. GET /api/v1/prices?country=mo&service=wechatで料金を確認します。
3. POST /api/v1/activationsに{"service": "wechat", "country": "mo"}を渡して注文し、返されたアクティベーションIDを保持します。
4. 受け取った+853番号を使って、アプリからSMSを発生させます。
5. GET /api/v1/activations/{id}のポーリング、またはactivation.sms_receivedのWebhookで結果を取得します。

WebhookにはX-OTPRoute-Signature: t=<unix>,v1=<hex>が付きます。エンドポイントのシークレットで<t>.<raw body>のHMAC-SHA256を検証し、古すぎるタイムスタンプは拒否して、ハンドラーはアクティベーションIDに対して冪等にしてください。保持できるのはキー10個とエンドポイント5つで、上限は1分あたり300リクエストです。ダッシュボードを使いたい場合は、マカオとサービスを選び、表示された価格を確認して番号をコピーし、コードが表示されるのを待ちます。

+853のコードが届かないときはどうすればよいか？

注文は20分間開いたままで、料金が発生するのはコードが届いたときだけです。ウィンドウが過ぎるか、POST /api/v1/activations/{id}/cancelでキャンセルすると、全額がウォレットに戻ります。

何も届かない場合は、ウィンドウが終わるまで待ち、そのうえでサービスが仮想番号を拒否していないか検討します。拒否するものもあり、返金はまさにそのための仕組みです。時間をおくか、別のサービスルートでやり直し、スクリプトの再試行が積み重ならないようにバックオフを加えてください。隣接するルートへの切り替えがテストに適しているのはどんなときかは、国別ルーティングの記事で説明しています。

マカオの番号を保持できるか、支払いはどうなるのか？

セルフサービスで利用できるマカオの長期回線はありません。SMSを受信し続け、ブラウザから発信もできるDedicated Numbersは、米国とカナダのみの販売で、$1.95/月からです。長期の+853回線が必要なチームは[email protected]までご連絡いただけますが、可能かどうかは現地の規制で決まります。

課金は、月額料金なしのプリペイドUSDウォレット1つで行います。カード決済とUSDT/USDCのステーブルコインのどちらでもチャージでき、チャージのたびに記録用のPDF請求書がメールで届きます。リクエストに応じて開発用アカウントをサンドボックスに切り替えられるので、まず模擬の番号とコードで構築できます。OTP Routeは自社の正当な製品とアカウントにのみ使い、すべてのサービスの規約とOTP RouteのAcceptable Use Policyを守ってください。

よくある質問

マカオにいなくても、マカオのサインアップフローをテストできるか？

はい。+853の国番号を持つOTP Gatewayの番号がSMSを受信し、ダッシュボードまたはAPIで読み取れます。

OTP Route APIで、マカオの国IDは何か？

GET /api/v1/prices?country=mo&service=whatsappのようなリクエストでmoを使います。

マカオの携帯番号は何桁か？

+853の後ろに8桁で、通常は6で始まります。取り除くべきトランクプレフィックスはありません。

テスト用の+853番号はいくらか？

サービスにより異なりますが、$0.20/コードからです。APIとダッシュボードで注文前に最新の価格が表示され、失敗した注文は返金されます。

コードは中国語で届くか？

届くことがあります。マカオの番号に届くコードは、繁体字中国語、英語、ときにポルトガル語なので、単語ではなく数字を解析してください。

マカオの長期番号は利用できるか？

セルフサービスの製品としてはありません。Dedicated Numbersは米国とカナダのみです。+853についてはサポートチームにメールでお尋ねください。

実際の番号の料金を払わずに連携を構築できるか？

はい。開発用アカウントにサンドボックスモードをリクエストすれば、模擬の番号とコードが得られます。

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