BILLING 使用者地址的形式儲存,之後可在 createVirtualCard 中以 userAddressId 傳入。
當提供 authUserId 時,地址會為該授權使用者所屬的底層使用者儲存,同時仍掛載在呼叫者的帳戶上。authUserId 必須是呼叫者帳戶上狀態為 ACTIVE 且非擁有者的授權使用者指派。
如果在呼叫者的帳戶上,目標持卡人已存在相同的帳單地址,系統將回傳既有地址而不是建立重複項。比對是基於地址欄位、帳戶、目標使用者,以及 BILLING 類型。
先決條件: 具有
CREATE_VIRTUALCARD 權限範圍的 Bearer 權杖。帳單地址必須可驗證此變更操作會儲存帳單地址。該地址必須為真實且可投遞的美國地址(
US、USA 或 United States),且城市、州別與郵遞區號需正確,並且不接受郵政信箱(PO boxes)。USPS/Smarty 檢查會在建立虛擬卡時進行——無法在該處通過驗證的地址,將導致卡片建立失敗並回傳 VC-0025。完整欄位規則與範例請參見 Address Formatting Requirements。如何串接運作
- 使用
addVirtualCardAddress儲存地址——你會取得一個userAddressId。 - 將該
userAddressId傳入createVirtualCard。此值優先於任何內嵌的billingAddress。 - 可在多張卡片間重複使用相同的
userAddressId——地址只在帳戶上儲存一次。
createVirtualCard 內嵌傳入 billingAddress 物件;系統會重用符合的已儲存地址,或建立新的地址。
下一步
新增虛擬卡地址
完整的變更操作契約——參數、回應、範例與錯誤代碼。
建立虛擬卡
使用已儲存的
userAddressId 來發行卡片。