地址欄位
每個地址物件都使用相同的結構化欄位。依不同呼叫，物件名稱可能為billingAddress、businessLegalAddress，或是所有者/個人的地址，但欄位名稱是一致的。
格式規則
以下規則適用於你在 API 任一部分提交的每個地址：- 使用結構化欄位。 將街道放在
streetAddressLine1，單位放在streetAddressLine2——不要把所有內容合併在同一行。 - 使用可投遞的真實地址。 門牌號碼必須存在於該街道上。僅有真實街道仍不足——若 Main St 的最大門牌為
480，則500 Main St無效。 - 城市、州別與 ZIP 一致。 郵遞區號必須與該城市與州別相符。ZIP 不匹配是地址被拒最常見的原因。
- 使用 USPS 縮寫。 標準尾綴（
St、Ave、Blvd、Dr、Ln、Rd、Ct、Pkwy）與方向（N、S、E、W、NE、NW、SE、SW）最能可靠匹配。 - 將單位/公寓/套房放在
streetAddressLine2，並使用可辨識的標示。若 USPS 要求該建物必須提供次要單位但未提供，地址可能無法通過驗證。 - 美國地址送 5 碼 ZIP。 ZIP+4 會在標準化過程中自動加入。
卡片簽發的其他要求
虛擬卡帳單地址在儲存前會透過 Smarty（USPS 投遞點驗證）進行驗證與標準化。此要求適用於新增虛擬卡地址、建立虛擬卡，以及授權使用者的卡片簽發。- 僅限美國地址。 將
country設為United States。 - 不可使用郵政信箱（PO box）。 即使 USPS 視為可投遞，發卡機構仍不接受郵政信箱地址。
- 必須通過 Smarty 驗證。 若地址無法匹配為真實、可投遞的美國投遞點，請求會以
VC-0025被拒且不會儲存任何地址。以相同值重試仍會失敗——必須變更地址本身。
依情境的國家限制
並非所有地址都僅限美國。請依你所進行的呼叫使用正確限制：為何地址會被拒（VC-0025）
對於卡片簽發，當 Smarty 無法確認該地址為可投遞的美國投遞點時，地址會失敗。最常見原因如下：
實例說明
範例 1 — 城市 / ZIP 不匹配
VC-0025）。 ZIP 10605 屬於White Plains, NY（Westchester 郡），而非紐約市——因此城市與 ZIP 不匹配。此外，2581 Oakwood Avenue 也不是該 ZIP 中已確認的投遞點。Smarty 未回傳有效匹配，故地址未被儲存。
修正方式： 提交 USPS 指派給該城市的 ZIP（或與該 ZIP 匹配的城市），以及存在於該街道上的門牌號碼。
範例 2 — 無效的門牌號碼
VC-0025）。 S State St 存在於 Dover, DE，但 896 並非該街道與 ZIP 的 USPS 已確認投遞點。由於無法驗證特定門牌號碼，Smarty 無法回傳可投遞的匹配。
修正方式： 確認正確的門牌號碼，以及覆蓋該街段的 ZIP。
有效的提交
在你的整合中處理 VC-0025
- 以結構化欄位收集地址，而不是單一自由文字欄位，便於提示需要修正的特定部分。
- 不要盲目重試。 相同地址會持續回傳
VC-0025。請顯示錯誤並要求使用者更正地址。 - 提交前先驗證（選用）。 在你的介面先進行地址自動完成或驗證可降低失敗往返。
- 失敗時不會儲存任何資料，因此修正後重試前無需清除。
錯誤參考
完整清單請參見虛擬卡錯誤代碼。
後續步驟
測試地址
已知可用與故意不可用的地址，用於在測試環境中演練各種驗證結果。
一般 API 錯誤代碼
瞭解地址錯誤在更廣泛錯誤代碼命名空間中的位置。
想了解更多？ 請聯絡我們：partnerships@fluz.app。與我們的專家洽談以取得更多資訊或申請示範。