VC-0025 錯誤處理。
虛擬卡帳單地址會透過 Smarty(USPS 投遞點驗證)進行驗證。完整規則請見 地址格式要求,包含哪些情境僅限美國。
測試環境鏡像正式環境地址驗證在測試環境與正式環境的行為一致,因此任何真實、目前可投遞的地址都會通過。以下範例僅為方便使用,並用於觸發特定結果。
美國測試地址
以下每筆都是真實、可由 USPS 投遞且能被 Smarty 乾淨通過的美國地址。任何真實、可投遞的「美國」地址都適用於 API 中「所有」地址欄位——虛擬卡、銀行帳戶、銀行卡、KYC 與 KYB。
要測試次要單位,請在
streetAddressLine2 加入有效的公寓或套房(例如 Apt 5 或 Ste 200)。
範例請求
國際測試地址
以下為真實、可投遞的非美國地址,適用於接受國際地址的情境測試。哪些情境接受國際地址國際地址可用於「銀行卡帳單地址」、「KYC」與「KYB」。但「銀行帳戶(ACH)地址」與「虛擬卡帳單地址」不接受國際地址——兩者皆僅限美國。對虛擬卡提交國際地址會回傳
VC-0025。
有些國家沒有州或省。由於大多數地址物件都需要
state,請提供最接近的行政區(例如省、郡或市轄區)。
未通過驗證的地址
使用下列地址確認你的應用能優雅處理VC-0025(與其他拒絕情況)。以下皆無法儲存為虛擬卡地址。
範例失敗請求
VC-0025。以相同值重試仍會失敗——必須先更正地址才能儲存。
下一步
你現在已擁有涵蓋沙盒各層面的測試資料——卡片、銀行帳戶、身分、商家與地址。是時候派上用場了。快速開始:你的第一筆禮品卡購買
從頭到尾執行完整的快樂路徑——存入資金、購買禮品卡並揭示它。
地址格式要求
這些結果背後的完整驗證規則,包含示範案例與錯誤處理。