> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 帳單地址總覽

在呼叫者的帳戶上儲存用於發行虛擬卡的帳單地址。此地址將以 `BILLING` 使用者地址的形式儲存，之後可在 `createVirtualCard` 中以 `userAddressId` 傳入。

當提供 `authUserId` 時，地址會為該授權使用者所屬的底層使用者儲存，同時仍掛載在呼叫者的帳戶上。`authUserId` 必須是呼叫者帳戶上狀態為 ACTIVE 且非擁有者的授權使用者指派。

如果在呼叫者的帳戶上，目標持卡人已存在相同的帳單地址，系統將回傳既有地址而不是建立重複項。比對是基於地址欄位、帳戶、目標使用者，以及 `BILLING` 類型。

<Info>
  **先決條件：** 具有 `CREATE_VIRTUALCARD` 權限範圍的 Bearer 權杖。
</Info>

<Note>
  **帳單地址必須可驗證**

  此變更操作會儲存帳單地址。該地址必須為真實且可投遞的**美國**地址（`US`、`USA` 或 `United States`），且城市、州別與郵遞區號需正確，並且**不接受郵政信箱（PO boxes）**。USPS/Smarty 檢查會在建立虛擬卡時進行——無法在該處通過驗證的地址，將導致卡片建立失敗並回傳 `VC-0025`。完整欄位規則與範例請參見 [Address Formatting Requirements](/concepts/address-formatting-requirements)。
</Note>

## 如何串接運作

1. 使用 `addVirtualCardAddress` 儲存地址——你會取得一個 `userAddressId`。
2. 將該 `userAddressId` 傳入 [`createVirtualCard`](/features/create-card)。此值優先於任何內嵌的 `billingAddress`。
3. 可在多張卡片間重複使用相同的 `userAddressId`——地址只在帳戶上儲存一次。

你也可以完全略過預先儲存，直接在 `createVirtualCard` 內嵌傳入 `billingAddress` 物件；系統會重用符合的已儲存地址，或建立新的地址。

## 下一步

<CardGroup cols={2}>
  <Card title="新增虛擬卡地址" icon="map-pin" href="/features/add-billing-address">
    完整的變更操作契約——參數、回應、範例與錯誤代碼。
  </Card>

  <Card title="建立虛擬卡" icon="credit-card" href="/features/create-card">
    使用已儲存的 `userAddressId` 來發行卡片。
  </Card>
</CardGroup>
