> ## 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，而非纽约市——且没有匹配的投递点。   |
| 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>