跳转到主要内容
在调用方的账户上保存用于虚拟卡发卡的账单地址。该地址将以 BILLING 用户地址的形式保存,之后可作为 userAddressId 传递给 createVirtualCard 当提供 authUserId 时,地址会为该授权用户所对应的底层用户保存,同时仍然附加在调用方的账户上。authUserId 必须是调用方账户上处于 ACTIVE 状态的非所有者授权用户指派。 如果在调用方的账户上,目标持卡人已存在完全相同的账单地址,则会返回现有地址,而不是创建重复项。匹配基于地址字段、账户、目标用户以及 BILLING 类型进行。
先决条件: 具有 CREATE_VIRTUALCARD 范围的 Bearer 令牌。
账单地址必须可验证此变更会存储账单地址。它必须是真实且可投递的美国地址(USUSAUnited States),并包含正确的城市、州和邮编,且不接受邮政信箱(PO Box)。USPS/Smarty 校验会在创建虚拟卡时运行——无法在那里通过验证的地址会导致发卡失败,错误码为 VC-0025。完整字段规则与示例见 地址格式要求

运行机制

  1. 使用 addVirtualCardAddress 保存地址——你会获得一个 userAddressId
  2. 将该 userAddressId 传递给 createVirtualCard。它将优先于任何内联的 billingAddress
  3. 可在任意数量的卡片上重复使用同一个 userAddressId——该地址仅在账户上保存一次。
你也可以完全跳过预保存,直接在 createVirtualCard 上内联传入一个 billingAddress 对象;系统会重用匹配的已保存地址,或创建一个新地址。

后续步骤

添加虚拟卡地址

完整的变更契约——参数、响应、示例与错误代码。

创建虚拟卡

使用已保存的 userAddressId 来发放一张卡。