コスタリカ(+506)の電話認証に適したツールを選ぶ

使い切りの+506番号と、保持する回線のどちらが必要ですか?

まず、その番号に紐づくアカウントが、この先どのくらいの頻度で再びコードを求めてくるかを考えてください。

• コードは1回だけで完了。登録テスト、ローンチ時のスモークチェック、コスタリカでの事業用アカウント1件の確認なら、OTP Gatewayが合っています。認証コード1回分の+506番号が手に入り、その後アクティベーションは閉じられます。
• 数か月にわたる繰り返しのログイン。この使い方には、保持できる番号が必要です。OTP Routeが販売するDedicated Virtual Numbersは、アメリカとカナダのみで、月額$1.95からです。SMSの受信と送信、ブラウザ通話が使えます。

コスタリカ向けのセルフサービスの長期回線はありません。運用上どうしても必要な場合は、[email protected]までご連絡ください。チームが検討しますが、提供できるかどうかは現地の規制によるため、お約束はできません。繰り返しサインインするステージング用アカウントには、そのサービスがその地域を受け付けるなら、アメリカやカナダの専用番号が現実的な答えになることが多いです。

コスタリカの認証番号にコードを送信できるアプリは何ですか?

コスタリカのルートには現在、800を超えるサービスが掲載されています。現在利用できる人気のものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、Uber、Airbnb、Microsoft & Outlook、Amazon、LinkedIn、Discord、ChatGPT (OpenAI)、Signal、Netflixなどがあります。

この一覧はスナップショットと考えてください。在庫は日中でも変動するため、このページを含むどのページの文面よりも、ライブの料金・利用可否の呼び出しが頼りになります。UberとAirbnbがコスタリカのテスト計画によく登場するのは、住民だけでなく旅行者向けにも開発するチームが、旅行や配車のフローを検証するからです。

コスタリカOTP APIは、リクエストからコード取得までどう動きますか?

すべてはhttps://otproute.com/api/v1に対して、開発者コンソールで生成したor_live_で始まるBearerキーを使って行います。1アカウントにつき、キーは最大10個、Webhookエンドポイントは5つまで保持でき、レート制限は毎分300リクエストです。

1. GET /api/v1/servicesとGET /api/v1/countriesを読み取り、名前とIDを対応付けます。コスタリカはcrです。
2. 各注文の前にGET /api/v1/prices?country=cr&service=<id>でライブ価格を確認します。
3. POST /api/v1/activationsに{"service": "whatsapp", "country": "cr"}のような本文を付けて、アクティベーションを作成します。返されたアクティベーションIDを保持しておきます。
4. テストする登録画面に、+506番号を入力します。
5. Webhookでactivation.sms_receivedを受け取ります。Webhookを使わない場合は、数秒ごとにGET /api/v1/activations/{id}を確認します。

コスタリカのテストが途中で中止になった場合は、POST /api/v1/activations/{id}/cancelで番号を返却すると、ウォレットに返金されます。WebhookのリクエストにはX-OTPRoute-Signature: t=<unix>,v1=<hex>が付きます。エンドポイントのシークレットで<t>.<raw body>のHMAC-SHA256を再計算して比較し、古いタイムスタンプは破棄してください。完全なリファレンスはドキュメントにあります。

コードを書かない人でも、+506番号を注文できますか?

はい。運用担当者や代理店のアカウントマネージャーは、通常ダッシュボードから作業します。

1. サインインして、OTP Gatewayを開きます。
2. サービスを選び、国としてコスタリカを選びます。
3. 確定前に表示される価格を確認します。
4. 番号を、アプリの認証フォームにコピーします。
5. アクティベーションを見守ります。コードが届くと、同じ画面に表示されます。

ダッシュボードとAPIは同じウォレットを共有しているため、QAエンジニアとマーケティング担当が、別々の設定をせずに同じ残高で作業できます。

コスタリカの番号とSMSについて、エンジニアが知っておくべきことは?

コスタリカは、トランクプレフィックスのない、8桁の国内番号による閉鎖型番号計画を採用しています。実際には、国内形式と国際形式の違いは国番号+506だけなので、正規化は簡単です。すべての番号を、+506に8桁を続けたE.164形式で保存し、ユーザーが途中に入れがちなスペースやハイフンは取り除いてください。

公用語はスペイン語なので、多くの認証メッセージはスペイン語で届きます。「Your code is」のような英語のフレーズに一致させるのではなく、本文から数字の並びを抽出するパーサーにしてください。チームがここでテストを行うのは、中米全域のスペイン語ローカライズ、現地のQAが必要なニアショアの開発グループ、旅行者と住民が同じ登録フローを使う旅行・ホスピタリティ系プロダクトなどのためです。これをリリースのチェックリストに組み込む方法は、QAテストガイドで解説しています。

+506のコードが届かない場合はどうなりますか?

結論を出す前に、アクティベーションに20分間の猶予を与えてください。何も届かなければ、キャンセルした場合と同様に、料金は自動的にウォレットに戻ります。

• ルートの利用状況は日中に変わるため、少し時間を置いて再試行する
• 同じ確認に別の送信元を使えるプロダクトなら、別のサービスルートを試す
• アプリがそもそも仮想番号を受け付けるか確認する(拒否するものもあり、まさにそのために返金ルールがあります)
• 短い間隔で再注文しない。試行の間隔を空け、クォータの消費やアプリ自身の制限に触れるのを避ける

手ごわい中米のルートに対するその他の対処法は、OTP配信失敗を減らすためのガイドにまとめています。

コスタリカのテスト実行の課金はどうなっていますか?

OTP Routeは、前払いのUSDウォレット1つによる従量課金で、月額料金もプランの選択もありません。チャージはカード、またはUSDT/USDCのステーブルコインで行え、チャージのたびにPDFの請求書がメールで届くため、複数のクライアントでテスト予算を共有する場合も経理チームが助かります。最新の概要は料金をご覧ください。

実際の注文の前に連携作業を行う場合は、開発用アカウントをサンドボックスに切り替えるよう依頼してください。シミュレートされた番号とコードが返されるため、ウォレットの資金に触れずにフロー全体をエンドツーエンドで実行できます。このサービスは自社の正当なアカウントとプロダクトにのみ使い、各アプリの利用規約を守ってください。また、利用規定(Acceptable Use Policy)が適用されることにもご注意ください。

よくある質問

現地のSIMなしで、アプリのコスタリカ向け登録フローをテストできますか?

はい。OTP Gatewayで+506番号を注文し、アプリに入力して、ダッシュボード、Webhook、またはアクティベーションのエンドポイントからコードを取得します。

OTP Route APIでのコスタリカの国IDは何ですか?

小文字のISOコードであるcrで、料金のクエリ文字列とアクティベーションのリクエスト本文の両方に指定します。

コスタリカの番号に、先頭のゼロはありますか?

いいえ。コスタリカにはトランクプレフィックスがないため、+506に8桁の国内番号を続けた形で保存し、それ以外は付けません。

繰り返しのログイン用に、コスタリカの番号を保持できますか?

セルフサービスではできません。長期回線はアメリカとカナダ向けの製品で、月額$1.95からです。コスタリカの回線については、[email protected]にメールでお問い合わせいただけますが、手配できるとは限りません。

+506の認証コードはいくらですか?

1コード$0.20 からで、正確な金額はサービスによって異なります。注文前に、APIとダッシュボードの両方でライブ価格が表示されます。

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

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

実際の注文にお金を払う前に、開発者が+506の連携を試せますか?

はい。サポートに依頼して開発用アカウントをサンドボックスモードに切り替えてもらえば、シミュレートされた+506番号とコードで、フロー全体を試せます。

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