アフガニスタンのSIMを持つ人がいなくても+93の登録フローをテストする

ユーザーは+93番号で登録しているのに、QAが再現できません。どうすればよいですか?

これは、送金アプリ、人道支援向け物流ツール、メッセージングサービス、そしてアフガニスタン系ディアスポラが多いマーケットプレイスでよくあるギャップです。サポートチケットには、コードが届かない、フォームが番号を拒否する、といった報告が並びますが、テストチームはベルリンやドバイ、トロントにいて、端末にアフガニスタンのSIMを挿す手段がありません。

OTP Gatewayのアフガニスタン認証番号がこのギャップを埋めます。1つのサービス向けに一時的な+93回線を注文し、テスト中のフローに入力すると、エンジニアがふだん作業している場所にコードが届きます。発送も、ローミングも、現地での登録も不要で、コードを使い終えた番号は廃止されます。

同じ方法は、リリース前にローカライズされたオンボーディングファネルを最初から最後まで確認したいプロダクトマネージャーや、パートナー連携のテストに+93番号が必要な運用チームにも向いています。

APIを通じてアフガニスタンのOTPをテストハーネスに取り込むには?

アフガニスタンOTP APIは他の国と同じ呼び出しを使い、変わるのは国IDだけです。アフガニスタンのIDは af です。

1. Developerコンソールで、or_live_ で始まるBearerキーを作成します。1アカウントで最大10個のキーと5つのWebhookエンドポイントを持て、上限は毎分300リクエストです。
2. GET /api/v1/services でサービスIDを調べ、GET /api/v1/prices?country=af&service=<id> でそのルートの現在の価格を確認します。
3. サービスと af を指定したJSON本文で POST /api/v1/activations を送信します。レスポンスにはアクティベーションIDと+93番号が含まれます。
4. GET /api/v1/activations/{id} をポーリングするか、Webhookの activation.sms_received イベントを待ちます。X-OTPRoute-Signature ヘッダー(タイムスタンプと生の本文のHMAC-SHA256)を検証し、古いタイムスタンプのリクエストは破棄します。
5. テストを中止する場合は、POST /api/v1/activations/{id}/cancel で番号を解放し、保留分を返金します。

APIリファレンスにすべてのエンドポイントが載っています。また、Webhookによる認証コード取得のガイドでは、再送されても冪等になるよう、イベントをアクティベーションIDで管理する方法を紹介しています。

現在、アフガニスタンの番号にコードを送れるアプリは?

af の最新スナップショットには、1,700を超えるサービスが載っています。よく依頼されるものには、WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、imo、Viber、Signal、TikTok、Microsoft & Outlook、LinkedIn、Discord、ChatGPT (OpenAI)があります。

その一覧でメッセージングアプリが多いのには理由があります。海外に暮らす多くのアフガニスタン人家族が音声通話やチャットアプリで連絡を取り合うため、それらと連携する製品には+93のトラフィックが多く集まります。提携キャリアが在庫を入れ替えるため、利用可否は一日の中で変わります。そのためAPIは、固定のカタログではなく、問い合わせた時点で注文できるものを返します。

APIを使わない人はどうすればよいですか?

サポート担当者やプロダクトオーナーは、すべてブラウザ上で完結できます。メールアドレスと6桁のコード(またはGoogleサインイン)で登録し、資金を追加してOTP Gatewayを開き、アフガニスタンとサービスを選んで、表示された価格を確認します。+93番号がすぐに表示されるので、テスト対象のアプリに貼り付け、タブを開いたままにしておいてください。SMSが届くと、コードが注文の横に表示されます。

複数の同僚が共有するアカウントでは、ダッシュボードの二要素認証(TOTP)を有効にしておくと安心です。

アフガニスタンの電話番号は、どう保存・正規化すればよいですか?

アフガニスタンの国コードは+93で、国内トランクプレフィックスは 0 です。国内では携帯電話番号を先頭の0付きで、たとえば07X XXX XXXXのように書きますが、国際形式ではその0を省いて+93 7X XXX XXXXとなります。データベースにはE.164形式(+937...)で保存し、+93の選択肢の隣に利用者が国内形式で入力した場合は先頭の 0 を取り除いてください。そうしないと、バリデーターが桁数を1つ多く数えてしまいます。

公用語はダリー語とパシュトー語ですが、大手のグローバルサービスは通常、英語か、アカウントや端末に設定された言語でコードのメッセージを送ります。自社アプリがSMSの内容(オートフィルのヒントなど)をどこかに表示する場合は、右から左へ書く言語のロケールと英語のロケールの両方でテストしてください。

コードが届きませんでした。チームは何を試すべきですか?

アフガニスタン向けのルートには品質のばらつきがあるため、たまに届かないことを想定しておきましょう。

• 20分の有効時間を最後まで待ちます。 遅れたSMSでも、期限前に届けば有効です。
• 返金ルールを思い出してください。 料金が発生するのはコードが届いたときだけで、期限切れやキャンセルになったアクティベーションは全額が自動的に返金されます。
• 時間を置くか、別のルートで再試行します。 少し後にもう一度注文するか、パキスタンのような近隣市場で同じサービスを試すと成功することがよくあります。
• サービスが仮想番号を受け付けるか確認します。 ポリシーとして拒否するサービスもあり、どのルートでもそれは変えられません。
• エンドポイントに連打しないでください。 短い間隔での再注文はレート制限を消費するだけで、配信は改善しません。試行の間隔を空けてください。

再試行の設計については、OTP配信失敗を減らすの記事でさらに詳しく解説しています。

来月のログイン用に+93回線を保持できますか?課金はどうなりますか?

セルフサービスのアフガニスタン長期回線はありません。専用番号は米国とカナダ限定の別製品で、月額$1.95から、受信・送信SMSとブラウザ通話が付きます。チームに長期の+93回線が本当に必要な場合は [email protected] までご連絡ください。手配できるかどうかは現地の規制によるため、お断りする場合もあります。

OTP Gatewayの課金は、月額料金もプラン選択もない、前払い式のUSDウォレット1つで行います。カードまたはUSDT/USDCでチャージでき、チャージのたびにPDFの請求書がメールで届きます。連携開発の際は、サポートに開発アカウントのサンドボックスモードへの切り替えを依頼してください。残高を使わずに、シミュレートされた番号とコードが返されます。料金の詳細は料金ページをご覧ください。

よくある質問

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

はい。OTP Gatewayで対象サービス向けの+93番号を注文してアプリに入力すれば、ダッシュボードまたはAPIでコードを読み取れます。

OTP Route APIでのアフガニスタンの国IDは何ですか?

af です。アクティベーションの作成や価格の照会で、country の値として指定します。

アフガニスタンのSMS OTPを受信するにはいくらかかりますか?

コードは$0.20/コードからです。正確な金額はサービスによって異なり、注文前に GET /api/v1/prices で取得できます。

認証SMSが届かなかった場合、料金は発生しますか?

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

アフガニスタンの番号は先頭の0を付けて保存すべきですか?

+93で始まり、トランクの 0 を除いたE.164形式で保存してください。入力では国内形式も受け付け、保存前に正規化します。

すべてのサービスがOTP Routeの+93番号を受け付けますか?

必ずしもそうではありません。仮想番号を拒否するサービスもあります。各サービスの規約と、自社の正当なアカウントや製品での利用に限定する当社の利用規定(Acceptable Use Policy)に従ってください。

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