> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 測試地址

使用這些地址在測試環境中演練整合流程中的地址步驟——虛擬卡開立、銀行卡帳單、KYC 與 KYB——包含 `VC-0025` 錯誤處理。

虛擬卡帳單地址會透過 [Smarty](https://www.smarty.com/)（USPS 投遞點驗證）進行驗證。完整規則請見 [地址格式要求](/concepts/address-formatting-requirements)，包含哪些情境僅限美國。

<Note>
  **測試環境鏡像正式環境**

  地址驗證在測試環境與正式環境的行為一致，因此任何真實、目前可投遞的地址都會通過。以下範例僅為方便使用，並用於觸發特定結果。
</Note>

## 美國測試地址

以下每筆都是真實、可由 USPS 投遞且能被 Smarty 乾淨通過的美國地址。任何真實、可投遞的「美國」地址都適用於 API 中「所有」地址欄位——虛擬卡、銀行帳戶、銀行卡、KYC 與 KYB。

| `streetAddressLine1`   | `city`         | `state` | `postalCode` |
| ---------------------- | -------------- | ------- | ------------ |
| 1600 Amphitheatre Pkwy | Mountain View  | CA      | 94043        |
| 5732 Lincoln Dr        | Minneapolis    | MN      | 55436        |
| 8084 Hogwarts Dr       | Rives Junction | MI      | 49277        |

要測試次要單位，請在 `streetAddressLine2` 加入有效的公寓或套房（例如 `Apt 5` 或 `Ste 200`）。

### 範例請求

```json theme={null}
{
  "input": {
    "billingAddress": {
      "streetAddressLine1": "1600 Amphitheatre Pkwy",
      "country": "United States",
      "city": "Mountain View",
      "state": "CA",
      "postalCode": "94043"
    }
  }
}
```

## 國際測試地址

以下為真實、可投遞的非美國地址，適用於接受國際地址的情境測試。

<Note>
  **哪些情境接受國際地址**

  國際地址可用於「銀行卡帳單地址」、「KYC」與「KYB」。但「銀行帳戶（ACH）地址」與「虛擬卡帳單地址」不接受國際地址——兩者皆僅限美國。對虛擬卡提交國際地址會回傳 `VC-0025`。
</Note>

| `streetAddressLine1`  | `city`  | `state` | `postalCode` | `country`      |
| --------------------- | ------- | ------- | ------------ | -------------- |
| 221B Baker Street     | London  | England | NW1 6XE      | United Kingdom |
| 100 Queen Street West | Toronto | ON      | M5H 2N1      | Canada         |
| 200 George Street     | Sydney  | NSW     | 2000         | Australia      |
| Unter den Linden 77   | Berlin  | Berlin  | 10117        | Germany        |

有些國家沒有州或省。由於大多數地址物件都需要 `state`，請提供最接近的行政區（例如省、郡或市轄區）。

## 未通過驗證的地址

使用下列地址確認你的應用能優雅處理 `VC-0025`（與其他拒絕情況）。以下皆無法儲存為虛擬卡地址。

| Address                                           | Result    | Why                                                               |
| ------------------------------------------------- | --------- | ----------------------------------------------------------------- |
| 2581 Oakwood Avenue, New York, NY 10605           | `VC-0025` | 城市與郵遞區號不符——`10605` 為 White Plains, NY，而非 New York City——且無相符的投遞點。 |
| 896 S State St, Dover, DE 19904                   | `VC-0025` | 門牌號 `896` 在該街道與郵遞區號下不是經確認的 USPS 投遞點。                              |
| 123 Fake St, Springfield, IL 62704                | `VC-0025` | 該街道不存在於 USPS 資料中。                                                 |
| PO Box 1001, Austin, TX 78701                     | Rejected  | 卡片發卡機構不接受郵政信箱（PO Box）。                                            |
| 221B Baker Street, London NW1 6XE, United Kingdom | `VC-0025` | 非美國地址——虛擬卡與銀行帳戶地址僅限美國。（對銀行卡帳單、KYC 與 KYB 有效——請見上方的國際測試地址。）         |

### 範例失敗請求

```json theme={null}
{
  "input": {
    "billingAddress": {
      "streetAddressLine1": "2581 Oakwood Avenue",
      "country": "United States",
      "city": "New York",
      "state": "NY",
      "postalCode": "10605"
    }
  }
}
```

回傳 `VC-0025`。以相同值重試仍會失敗——必須先更正地址才能儲存。

## 下一步

你現在已擁有涵蓋沙盒各層面的測試資料——卡片、銀行帳戶、身分、商家與地址。是時候派上用場了。

<CardGroup cols={2}>
  <Card title="快速開始：你的第一筆禮品卡購買" icon="gift" href="/quickstart">
    從頭到尾執行完整的快樂路徑——存入資金、購買禮品卡並揭示它。
  </Card>

  <Card title="地址格式要求" icon="map-pin" href="/concepts/address-formatting-requirements">
    這些結果背後的完整驗證規則，包含示範案例與錯誤處理。
  </Card>
</CardGroup>