選擇帳戶
issued 表示 Swipelux 建立並管理該資源。external 則記錄客戶擁有的端點。第三方端點應歸類於收款人與目的地,而不是客戶帳戶清單。
建立帳戶
使用POST /v3/customers/{customerId}/accounts。搭配下方任一請求主體傳送以下標頭:
- 發行錢包
- 發行銀行帳戶
- 外部錢包
- 外部銀行帳戶
等待帳戶可用
從建立回應中儲存data.id、data.status 與 data.openTaskIds。在報價轉帳或顯示銀行資料前,使用 GET /v3/customers/{customerId}/accounts/{accountId} 讀取最新的帳戶。
僅在帳戶當前狀態允許下一步操作時使用該帳戶。若仍有待辦任務 ID,請依照能力與任務 完成。
發行的銀行帳戶在佈建期間可能會回傳 details: null。僅在最近一次讀取回傳完整資料後才呈現銀行資料。若 details.referenceRequired 為 true,請與銀行資料一起顯示完整的 details.reference。
明確地保持帳戶角色
對於出金,發行錢包是in.accountId 中的來源。客戶名下的銀行帳戶則為 destinationId。對於發行的銀行帳戶,settlement.accountId 是接收匹配存款的發行錢包。
接下來,請在接收資金、發送資金 或發行銀行帳戶 中使用已就緒的帳戶。