住所検証

その 住所検証 このサービスは、各カードの配送先住所を製造前に確認します。目的はシンプルです。配送不能な住所を理由に返品されるカードの数を減らすことです。

• 有効な住所 → カードは製造され、発送されます。
• 無効な住所 → カード注文は拒否され、住所を修正して再注文できるように通知されます。

検証は注文フロー中に自動的に実行されます。イシュアのバックエンドから追加の API 呼び出しは不要です。

仕組み

1. イシュアのバックエンドが、エンドユーザーの配送先住所を含むカード注文を送信します。
2. D1 が注文を受け付けます（HTTP 202）。住所検証は後で実行されます。
3. D1 が入力内容（形式、長さ、許可された文字）を検証します。
4. D1 が住所を検証サービスに送信します
5. D1 がイシュア設定のしきい値に照らして応答を評価します。
6. 結果:

   1. 有効 → カードは製造に進みます。通知が送信されます。
   2. 無効 → カードは拒否されます。理由付きの通知が送信されます（必要に応じて、修正候補の住所も含まれます）。
7. 必要であれば、イシュアは修正済みの住所でカードを再注文します。

検証モードの選択

オンボーディング時に1つのモードが選択されます。これはすべてのカード注文に適用されます。

モード	何が起こるか	使用タイミング
無効	検証なし。すべてのカードが製造されます。	このサービスを使いたくない場合。
統計	検証は実行されますが、カードは 常に製造されます.	強制適用を有効にする前に影響を測定するため。
有効	検証は実行されます。無効な住所は 拒否されます.	標準的な製造用途。
プレミアム	同じですが、 有効さらに 修正候補の住所 が利用可能な場合は返されます。	拒否された住所の修正を手伝ってほしい場合。

設定する必要がある項目

重要なのは、いくつかのパラメータだけです。

パラメータ	説明	推奨
addressValidation	モード: 無効 / 統計 / 有効 / プレミアム	有効
addressValidationMatchScoreThreshold	最小品質スコア（0〜100）。これを下回ると、住所は拒否されます。	95
addressValidationOnReorder	true の場合、以前に拒否されたカードを再注文するときに住所が再検証されます。false の場合、再注文では検証がスキップされます。	false
addressValidationOutageFallback	検証サービスが一時的に利用できない場合の動作: 生成（カードを受け入れる）または拒否（カードを拒否する）。	生成

その他の技術的パラメータ（プロバイダー、再試行戦略、郵便番号のしきい値など）は内部で管理されており、あなた側での対応は不要です。

受け取る通知

住所が有効 – カードは製造に進みます

{
  "operation": "PRODUCE",
  "status": "PENDING",
  "details": {
    "status": "CARD_PROD_REQUESTED",
    "addressValidation": {
      "status": "valid",
      "matchScore": 95
    }
  }
}

住所が無効 – カードは拒否されます

{
  "operation": "PRODUCE",
  "status": "FAILED",
  "errorCode": "INVALID_ADDRESS",
  "details": {
    "status": "DATA_EXCEPTION",
    "addressValidation": {
      "status": "invalid",
      "matchScore": 55
    }
  }
}

住所が無効 – 修正候補付き（プレミアムモード）

{
  "operation": "PRODUCE",
  "status": "FAILED",
  "errorCode": "INVALID_ADDRESS",
  "details": {
    "status": "DATA_EXCEPTION",
    "addressValidation": {
      "status": "invalid",
      "matchScore": 55,
      "suggestedAddress": {
        "line1": "221B Baker Street",
        "line2": "Flat 2",
        "city": "London",
        "postalCode": "NW1 6XE",
        "countryCode": "GB"
      }
    }
  }
}

カードが拒否された場合はどうなりますか?

1. errorCode = INVALID_ADDRESS の PRODUCE / FAILED 通知を受け取ります。
2. で プレミアム モードでは、修正候補の住所が提案される場合があります。
3. あなたは 住所を修正し そして 再注文し そのカードを。

サービスの可用性と信頼性

• 検証サービスは、すべてのカード注文に対してリアルタイムで呼び出されます。
• プロバイダーに一時的に到達できない場合、サービスは自動的に再試行します。
• すべての再試行後、設定された フォールバック （生成または拒否）が適用されます。
• 対象国のカバー率と精度は Loqate の参照データに依存します — Loqate の国別カバレッジ.