BILLING 用户地址的形式保存,之后可作为 userAddressId 传递给 createVirtualCard。
当提供 authUserId 时,地址会为该授权用户所对应的底层用户保存,同时仍然附加在调用方的账户上。authUserId 必须是调用方账户上处于 ACTIVE 状态的非所有者授权用户指派。
如果在调用方的账户上,目标持卡人已存在完全相同的账单地址,则会返回现有地址,而不是创建重复项。匹配基于地址字段、账户、目标用户以及 BILLING 类型进行。
先决条件: 具有
CREATE_VIRTUALCARD 范围的 Bearer 令牌。账单地址必须可验证此变更会存储账单地址。它必须是真实且可投递的美国地址(
US、USA 或 United States),并包含正确的城市、州和邮编,且不接受邮政信箱(PO Box)。USPS/Smarty 校验会在创建虚拟卡时运行——无法在那里通过验证的地址会导致发卡失败,错误码为 VC-0025。完整字段规则与示例见 地址格式要求。运行机制
- 使用
addVirtualCardAddress保存地址——你会获得一个userAddressId。 - 将该
userAddressId传递给createVirtualCard。它将优先于任何内联的billingAddress。 - 可在任意数量的卡片上重复使用同一个
userAddressId——该地址仅在账户上保存一次。
createVirtualCard 上内联传入一个 billingAddress 对象;系统会重用匹配的已保存地址,或创建一个新地址。
后续步骤
添加虚拟卡地址
完整的变更契约——参数、响应、示例与错误代码。
创建虚拟卡
使用已保存的
userAddressId 来发放一张卡。