Skip to main content
每個帳戶皆歸屬於單一客戶。請從兩個面向來選擇:由誰管理,以及它是錢包還是銀行帳戶。 客戶帳戶的清單、建立、讀取、更新與封存操作位於 /v3/customers/{customerId}/accounts 下；單一帳戶操作會再加上 /{accountId}。API 不支援從 accountId 反查 customerId。請將每個 accountId 與對應的 customerId 一併儲存，讓後續請求能指定該帳戶。

​
選擇帳戶

issued 表示 Swipelux 建立並管理該資源。external 則記錄客戶擁有的端點。第三方端點應歸類於收款人與目的地,而不是客戶帳戶清單。 在開始商家面板中用於卡片或 Apple Pay 的 First pay-in 引導之前，請先為該客戶建立 Polygon 錢包。此引導只會提供該 Polygon 錢包，沒有它便無法繼續。這項先決條件適用於商家面板引導；直接 API 整合只能使用針對目前客戶與功能所傳回的幣別、網路、方法與帳戶類型。

​
建立帳戶

使用 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 是接收匹配存款的發行錢包。 接下來,請在接收資金、發送資金 或發行銀行帳戶 中使用已就緒的帳戶。