メッセージングブランドを再認証する

修正済みの事業者の本人情報を再確認する

既存の組織ブランドについて、修正した本人情報を再度確認する必要がある場合に、この操作を使用します。まず、既存のブランドを更新し、その後、現在の本人確認ステータスを取得してください。通常のプロフィール更新では、この別料金の確認は申請されません。再認証によって別のブランドが作成されたり、キャンペーンが登録されたりすることはありません。

許可された送信元IPから、HTTPS経由で、ご自身の有効なAPIアカウントを使用してください。ブランドはそのアカウントに属している必要があります。ブランドの記録には事業者情報と連絡先情報が含まれるため、非公開で管理してください。

申請前にブランドを確認する

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID" \
  --output current-brand.json

返されたブランドが対象の事業者のものであり、修正内容が反映されていることを確認してください。最初の登録が保留中の場合は、まだ再認証できません。事業者情報に変更がない場合、登録機関がリクエストを拒否することがあります。特殊な属性が不足している場合は、再度の本人確認ではなく異議申し立てが必要になることがあります。個人事業主のブランドでは、適切な本人確認・PINの手順を使用してください。このエンドポイントをその代わりに使用しないでください。

別途発生する料金を確認する

現在設定されている本番環境の再認証料金は、受理された確認申請ごとにUS$5.00です（十月24日、2026年に確認）。元の事業体の登録料金が異なる場合も、標準のブランド料金が適用されます。購入が有効になっている必要があります。前払いアカウントでは、申請前に十分な残高が必要です。

202レスポンスは、後続の処理のためにリクエストが受理されたことを意味し、受理時点で課金処理が送られます。事業者の本人確認が完了したことを意味するものではありません。後で新たに確認を申請すると、追加料金が発生することがあります。確認が保留中のままであるという理由だけで、新たな確認を申請しないでください。

意図した確認を一度だけ申請する

curl --silent --show-error --fail-with-body --user "$API_USER:$API_PASSWORD" \
  --request PUT \
  --header "Idempotency-Key: $IDEMPOTENCY_KEY" \
  "https://api.multitel.net/tcr/v2/brand/$BRAND_ID/revet"

保存済みのブランド情報を確認するため、プロフィールを含むリクエストボディは不要です。意図した確認申請に固有の冪等性キーを使用し、再試行時にはメソッド、パス、クエリ、ボディを完全に同じ内容に保ってください。キーには、空白を含まない1–128文字の印字可能なASCII文字を使用できます。処理中の申請と重複した場合、Retry-Afterを伴う409が返されることがあります。完了済みの申請では、エラーを含め、保存された結果が再び返されることがあります。

公開APIでは、有効なトークンアカウントのBearer認証も利用できます。アカウントの所有関係と許可された送信元IPのチェックは引き続き適用されます。保存されたモックブランドは、この本番環境の課金処理をスキップしますが、サンドボックスの結果は本番環境の本人確認にはなりません。

結果を確認し、ステータスに応じて対応する

プロキシは変更リクエストの受理後にローカルのブランド記録を更新しますが、その更新自体は最終的な確認結果を証明しません。事業者は未確認または保留中のままである場合があります。キャンペーンの設定を続ける前に、HTTPでの受理だけで判断せず、現在のブランドステータスを確認してください。

結果が不明な場合に状況を確認する

通信障害により、キャッシュされた502が返されることがあります。上流でリクエストが受理された後にローカルでの永続化または課金に失敗すると、requestIdを伴う500がキャッシュされて返されることがあります。その識別子を保存し、サポートとともに現在のブランドと課金の状態を照合してください。別のキーを生成すると、別途課金される確認申請が作成される可能性があります。状況を確認せずに新しいキーで再試行しないでください。

顧客ポータルを利用する

ポータルでは、現在のプロフィールと料金を確認した後、UNVERIFIED状態の本番環境の組織ブランドに対して再認証を申請できます。プロフィールと料金が変更されていないことをチェックし、同じ現在の情報ですでに受理された申請がある場合は、追加の申請を拒否します。サンドボックスのブランドと個人事業主のブランドは、このポータル操作の対象外です。

これらのポータルの保護機能は、ワークフローに追加されたチェックです。APIを直接利用するクライアントは独自に確認を行う必要があり、APIでもポータルのバージョンフィールドや料金確認フィールドが必須であると想定してはいけません。通常のブランド情報の修正を保存する操作は別の操作であり、再認証が自動的に申請されることはありません。