跳轉到主要內容
使用這些地址在測試環境中演練整合流程中的地址步驟——虛擬卡開立、銀行卡帳單、KYC 與 KYB——包含 VC-0025 錯誤處理。 虛擬卡帳單地址會透過 Smarty(USPS 投遞點驗證)進行驗證。完整規則請見 地址格式要求,包含哪些情境僅限美國。
測試環境鏡像正式環境地址驗證在測試環境與正式環境的行為一致,因此任何真實、目前可投遞的地址都會通過。以下範例僅為方便使用,並用於觸發特定結果。

美國測試地址

以下每筆都是真實、可由 USPS 投遞且能被 Smarty 乾淨通過的美國地址。任何真實、可投遞的「美國」地址都適用於 API 中「所有」地址欄位——虛擬卡、銀行帳戶、銀行卡、KYC 與 KYB。 要測試次要單位,請在 streetAddressLine2 加入有效的公寓或套房(例如 Apt 5Ste 200)。

範例請求

國際測試地址

以下為真實、可投遞的非美國地址,適用於接受國際地址的情境測試。
哪些情境接受國際地址國際地址可用於「銀行卡帳單地址」、「KYC」與「KYB」。但「銀行帳戶(ACH)地址」與「虛擬卡帳單地址」不接受國際地址——兩者皆僅限美國。對虛擬卡提交國際地址會回傳 VC-0025
有些國家沒有州或省。由於大多數地址物件都需要 state,請提供最接近的行政區(例如省、郡或市轄區)。

未通過驗證的地址

使用下列地址確認你的應用能優雅處理 VC-0025(與其他拒絕情況)。以下皆無法儲存為虛擬卡地址。

範例失敗請求

回傳 VC-0025。以相同值重試仍會失敗——必須先更正地址才能儲存。

下一步

你現在已擁有涵蓋沙盒各層面的測試資料——卡片、銀行帳戶、身分、商家與地址。是時候派上用場了。

快速開始:你的第一筆禮品卡購買

從頭到尾執行完整的快樂路徑——存入資金、購買禮品卡並揭示它。

地址格式要求

這些結果背後的完整驗證規則,包含示範案例與錯誤處理。