> For the complete documentation index, see [llms.txt](https://docs.payments.thalescloud.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payments.thalescloud.io/central-issuance/ja/wosuru/zhu-suo-jian-zheng.md).

# 住所検証

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

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

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

### 仕組み

<figure><img src="/files/b18d0a01bc180fc9b3d8cbffde4fbfade006bc6e" alt=""><figcaption></figcaption></figure>

1. イシュアのバックエンドが、エンドユーザーの配送先住所を含むカード注文を送信します。
2. D1 が注文を受け付けます（HTTP 202）。住所検証は後で実行されます。
3. D1 が入力内容（形式、長さ、許可された文字）を検証します。
4. D1 が住所を検証サービスに送信します
5. D1 がイシュア設定のしきい値に照らして応答を評価します。
6. 結果:
   1. 有効 → カードは製造に進みます。通知が送信されます。
   2. 無効 → カードは拒否されます。理由付きの通知が送信されます（必要に応じて、修正候補の住所も含まれます）。
7. 必要であれば、イシュアは修正済みの住所でカードを再注文します。

### 検証モードの選択

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

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

### 設定する必要がある項目

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

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

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

### 受け取る通知

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

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

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

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

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

```json
{
  "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 の国別カバレッジ](https://docs.loqate.com/data-coverage/introduction).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.payments.thalescloud.io/central-issuance/ja/wosuru/zhu-suo-jian-zheng.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.