ドミニカ共和国のサインアップをテストする:事前チェックリストと手順

ドミニカ共和国の番号を注文する前に、チェックリストには何を入れるべきですか?

新しい市場でのテストが失敗する原因の多くは、ルートではなく準備にあります。最初のアクティベーションの前に、次の項目を確認してください。

• テスト対象アプリのサービスID。GET /api/v1/servicesから取得します。
• 国IDのdo。GET /api/v1/countriesで確認します。
• そのペアのリアルタイム価格。GET /api/v1/prices?country=do&service=<id>で取得し、テスト予算を事前に把握します。
• ウォレット残高。GET /api/v1/balanceで確認し、CIジョブが途中で止まらないようにします。
• Developerコンソールに登録したWebhookエンドポイント。署名シークレットはシークレット管理ツールに保管します。
• 番号を汎用の+1回線ではなく、地域DOとして扱うよう設定した電話番号パーサー。
• 自社でドミニカのユーザーにコードを送る場合は、認証テンプレートのスペイン語の文面のレビュー。

QAテストガイドでは、こうした事前チェックリストをチームがどう組み立てているかを詳しく説明しています。

ドミニカ共和国の電話番号は、どのような形式で保存しますか?

ドミニカ共和国は北米番号計画(NANP)に属しているため、番号は米国、カナダ、カリブ海の多くの国と国番号+1を共有しています。この国では809、829、849の3つの市外局番が使われます。完全な番号は+1の後に10桁が続き、取り除くべきトランクの0はありません。

エンジニアが見落としがちなのが、この共通のプレフィックスです。+1の番号をすべて米国に対応づけるバリデーターは、ドミニカのユーザーに誤ったラベルを付け、誤ったロケールを適用し、ときには誤ったサポート窓口に回してしまいます。番号はE.164形式(+1809…、+1829…、+1849…)で保存し、各レコードにISO地域のDOを併せて持たせ、国は国番号だけでなく市外局番から導き出してください。ユーザーが809-555-0100のような国内表記で入力した場合は、入力時に正規化し、表示では国内スタイルで返します。

プロダクトチームはなぜ、ドミニカ共和国の+1番号でテストするのですか?

公用語はスペイン語なので、ドミニカでのテストは、スペインやメキシコ以外で行うスペイン語のオンボーディングフローの最初の本格的な確認になることがよくあります。実務的な理由はいくつかあります。

• カリブ海でのローンチ:サインアップ画面、同意文、エラーメッセージが、ドミニカのユーザーにとって正しく読めるかを確認します。
• 在外ドミニカ人の顧客:多くのドミニカ人が米国に住んでおり、双方にサービスを提供するアプリは、どちらの+1番号も受け付ける必要があります。
• ホスピタリティと旅行のオペレーション:観光が経済の大きな部分を占めるため、予約アプリや配車アプリがここでよくテストされます。
• メッセージの言語:グローバルなサービスは通常、アカウントや端末の言語に合わせてSMSをローカライズし、現地の送信元はスペイン語で書く傾向があります。抽出ロジックは、周囲の言葉に頼らず、数字を読み取るようにしてください。

ドミニカ共和国の認証用番号にコードを送れるサービスはどれですか?

doの最新のスナップショットには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Uber、Airbnb、Amazon、Microsoft & Outlook、Discord、Signal、Netflix、eBayなどの人気アプリが掲載されています。カタログ全体では、このルートは1,000を超えるサービスに対応しています。

特定のペアの提供状況は、キャリアパートナーが容量を追加したり消費したりするため、日中に変動します。上のリストは目安とし、判断はAPIに任せてください。GET /api/v1/pricesが返すのは、今まさに注文できるものだけです。

ステップごとの手順:APIでドミニカ共和国のSMS OTPを受信する

1. すべての呼び出しに、or_live_で始まるBearerキーで認証を行います。1アカウントにつき最大10個のキーを持てます。
2. ボディ{"service": "<id>", "country": "do"}でPOST /api/v1/activationsを送ります。レスポンスにはアクティベーションIDと+1の番号が含まれます。
3. その番号を、テスト対象アプリのサインアップフォームに入力します。
4. Webhookでactivation.sms_receivedを待ちます。X-OTPRoute-Signatureヘッダーは、エンドポイントのシークレットで、タイムスタンプ、ドット、生のボディに対するHMAC-SHA256を計算して確認し、古いタイムスタンプは拒否します。
5. 公開エンドポイントを用意できない場合は、代わりにGET /api/v1/activations/{id}をポーリングします。上限の1分300リクエストを超えないようにしてください。
6. テストを中断したときはPOST /api/v1/activations/{id}/cancelを呼び、資金をすぐに戻します。

APIリファレンスにはすべてのフィールドが載っており、HMACによるOTP Webhookの保護の記事では、署名の確認をさらに詳しく解説しています。

ステップごとの手順:開発者でない人のためのダッシュボード経由の方法

サポートリーダーやマーケターも、コードなしで同じテストを実行できます。メールアドレスと6桁のコードでアカウントを作成し、ウォレットにチャージし、サービスを選び、ドミニカ共和国を選んで、表示された番号をコピーします。認証のテキストメッセージが届くと、アクティベーションカードに表示されます。各番号が受け取れるコードは1つで、注文は20分後に終了します。何も届かなかった場合は、自動的にウォレットへ返金されます。

トラブルシューティング、長期回線、料金の扱い

コードが表示されないときは、再注文する前に次のリストを確認してください。

• 20分の有効時間が終わるまで待ちます。送信元によってはメッセージをキューに溜めるものがあります。
• 対象アプリが仮想番号を拒否していないかを確認します。拒否するアプリもあり、だからこそ使われなかった注文は返金されます。
• 同じペアで時間をおいて再試行するか、フローが許すなら別のサービスルートを試します。
• 短い間隔での再注文は避け、試行の間隔を空けてください。

ドミニカ共和国のセルフサービスの長期番号はありません。保持できる回線が必要な場合は、[email protected]までメールしてください。提供できるかどうかは現地の規制によります。専用回線は米国とカナダ向けの製品で、1か月$1.95からです。

ウォレットはUSDの前払いで、月額料金はありません。クレジットカードまたはUSDT/USDCでチャージでき、支払いごとにPDFの請求書がメールで届きます。連携の開発中は、サポートに依頼して開発用アカウントをサンドボックスに切り替えてもらうと、シミュレーションされた番号とコードが返されます。現在の料金モデルは料金ページをご覧ください。

よくある質問

現地のSIMがなくても、自社アプリのドミニカ共和国向けサインアップをテストできますか?

はい。OTP Gatewayで国doの+1番号を注文し、コードをダッシュボードまたはAPIで読み取ります。SIMや端末は必要ありません。

ドミニカ共和国の番号はどの市外局番を使いますか?

ドミニカの番号は、国番号+1のもとで市外局番809、829、849を使います。E.164形式で保存し、各レコードに地域のDOを併せて持たせてください。

ドミニカ共和国の認証用番号はいくらですか?

ドミニカ共和国のアクティベーションは1コード$0.20からで、金額はアプリごとに異なります。正確な金額は、注文前にGET /api/v1/pricesから返されます。

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

いいえ。20分以内にメッセージが届かなかった場合、または先にキャンセルした場合は、全額がウォレットに戻ります。

同じドミニカの番号を、今後のログインのために保持できますか?

セルフサービスでは提供していません。使い捨ての番号が受け取れるコードは1つだけです。長期のオプションについては、[email protected]にメールでお問い合わせください。現地の規制によって異なります。

OTP Routeは自動テストスイートに向いていますか?

はい。RESTエンドポイント、署名付きWebhook、そしてオプションのサンドボックスアカウントにより、CIジョブでドミニカ向けサインアップフローをエンドツーエンドで検証できます。各アプリの利用規約とOTP Routeの利用規定(Acceptable Use Policy)に従ってください。

ドミニカ共和国の認証メッセージはスペイン語で届きますか?

スペイン語で届くことが多いですが、多くのグローバルアプリは、アカウントや端末に設定された言語でSMSを書きます。固定の文言ではなく、数字のコードを解析してください。

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