跳轉到主要內容
在呼叫者的帳戶上儲存用於發行虛擬卡的帳單地址。此地址將以 BILLING 使用者地址的形式儲存,之後可在 createVirtualCard 中以 userAddressId 傳入。 當提供 authUserId 時,地址會為該授權使用者所屬的底層使用者儲存,同時仍掛載在呼叫者的帳戶上。authUserId 必須是呼叫者帳戶上狀態為 ACTIVE 且非擁有者的授權使用者指派。 如果在呼叫者的帳戶上,目標持卡人已存在相同的帳單地址,系統將回傳既有地址而不是建立重複項。比對是基於地址欄位、帳戶、目標使用者,以及 BILLING 類型。
先決條件: 具有 CREATE_VIRTUALCARD 權限範圍的 Bearer 權杖。
帳單地址必須可驗證此變更操作會儲存帳單地址。該地址必須為真實且可投遞的美國地址(USUSAUnited States),且城市、州別與郵遞區號需正確,並且不接受郵政信箱(PO boxes)。USPS/Smarty 檢查會在建立虛擬卡時進行——無法在該處通過驗證的地址,將導致卡片建立失敗並回傳 VC-0025。完整欄位規則與範例請參見 Address Formatting Requirements

如何串接運作

  1. 使用 addVirtualCardAddress 儲存地址——你會取得一個 userAddressId
  2. 將該 userAddressId 傳入 createVirtualCard。此值優先於任何內嵌的 billingAddress
  3. 可在多張卡片間重複使用相同的 userAddressId——地址只在帳戶上儲存一次。
你也可以完全略過預先儲存,直接在 createVirtualCard 內嵌傳入 billingAddress 物件;系統會重用符合的已儲存地址,或建立新的地址。

下一步

新增虛擬卡地址

完整的變更操作契約——參數、回應、範例與錯誤代碼。

建立虛擬卡

使用已儲存的 userAddressId 來發行卡片。