地址字段
每个地址对象都使用相同的结构化字段。根据具体调用，对象可能命名为billingAddress、businessLegalAddress，或为所有者/个人地址，但字段名称保持一致。
格式规则
以下规则适用于你在 API 任意部分提交的所有地址：- 使用结构化字段。 将街道放在
streetAddressLine1，将单元放在streetAddressLine2——不要把所有内容合并到一行。 - 使用真实、可投递的地址。 门牌号必须存在于所述街道上。仅有真实街道不够——如果 Main St 的最高门牌是
480，则500 Main St无效。 - 保持城市、州和 ZIP 一致。 ZIP 码必须与该城市和州匹配。ZIP 不匹配是地址被拒的最常见原因。
- 使用 USPS 缩写。 标准后缀（
St、Ave、Blvd、Dr、Ln、Rd、Ct、Pkwy）和方位（N、S、E、W、NE、NW、SE、SW）最可靠。 - 将单元/公寓/套房放在
streetAddressLine2并使用可识别的标识符。若 USPS 要求某栋建筑提供二级单元而未提供，地址可能无法通过校验。 - 美国地址请发送 5 位 ZIP。标准化过程中会自动添加 ZIP+4。
卡片签发的额外要求
虚拟卡账单地址在保存前会通过 Smarty（USPS 投递点校验）进行验证与标准化。此要求适用于 添加虚拟卡地址、创建虚拟卡，以及为授权用户签发虚拟卡。- 仅限美国地址。 将
country设为United States。 - 不可使用邮政信箱（PO Box）。 发卡方不接受邮政信箱地址，即使 USPS 认为其可投递。
- 必须通过 Smarty 验证。 如果地址无法匹配到真实、可投递的美国投递点，请求将以
VC-0025被拒，且不会保存任何地址。使用相同值重试仍会失败——必须更改地址本身。
按上下文的国家要求
并非所有地址都仅限美国。请根据你所进行的调用使用正确的约束：地址被拒的原因（VC-0025）
对于卡片签发，当 Smarty 无法确认地址为可投递的美国投递点时，会判定失败。最常见的原因：
实际示例
示例 1 — 城市/ZIP 不匹配
VC-0025）。 ZIP 码 10605 属于White Plains, NY（威彻斯特县），而非纽约市——因此城市与 ZIP 不匹配。此外，2581 Oakwood Avenue 并非该 ZIP 中的已确认投递点。Smarty 未返回有效匹配，故地址未被保存。
修正方法： 提交 USPS 为该城市分配的 ZIP（或与 ZIP 匹配的城市），以及在该街道上存在的门牌号。
示例 2 — 无效门牌号
VC-0025）。 S State St 存在于 Dover, DE，但 896 并不是该街道与 ZIP 的 USPS 已确认投递点。由于无法验证具体门牌号，Smarty 未返回可投递匹配。
修正方法： 确认精确的门牌号以及覆盖该街道街区的 ZIP。
有效提交示例
在集成中处理 VC-0025
- 以结构化字段收集地址，而非单个自由文本字段，这样你可以提示修正具体有问题的部分。
- 不要盲目重试。 相同的地址会持续返回
VC-0025。请将错误呈现给用户并要求其更正地址。 - 提交前先校验（可选）。 在你的 UI 中运行地址自动完成或验证步骤可减少失败的往返请求。
- 失败时不会保存任何内容，因此在用更正后的值重试前无需清理。
错误参考
完整列表参见虚拟卡错误代码。
下一步
测试地址
在预发布环境中用于覆盖所有校验结果的有效与无效地址集合。
通用 API 错误代码
地址错误在更广泛错误代码命名空间中的位置。
想了解更多？ 通过 partnerships@fluz.app 联系我们。与我们的专家交流以获取更多信息或申请演示。