Skip to main content
本頁列出 Swipelux API 依日期排序的變更。每則條目會註明受影響的版本、變更類型,以及整合方需採取的任何行動。 若要將既有整合從較早版本升級,請參閱遷移至 v3。

未發布

即將推出的變更會在出貨前列於此處。

2026-09-08

版本: v3

變更

  • POST /v3/transfers 與轉帳讀取現在使用 checkoutMethod 而非 paymentMethod 來預先選擇卡片結帳方式,並接受 card、apple_pay、google_pay、cash_app、sepa 與 blik。此清單是開放的且可能增加。paymentMethod 不再被識別;仍傳送該欄位的請求會被視為省略了它。sepa 與 blik 是卡片結帳內部的付款選項,而不是 Swipelux 的能力。請參閱接收資金。

2026-09-07

版本: v3

新增

  • POST /v3/transfers 現在接受選用的 paymentMethod(card、apple_pay 或 google_pay),用於卡片報價。當請求的方式對客戶及其裝置可用時,託管結帳會以該方式開啟;轉帳讀取會回傳該請求,報價的金額與費用保持不變。請參閱接收資金。

2026-08-31

版本: v3

新增

  • 為沒有受益所有人的企業要求功能時,現在會建立用於新增受益所有人的受理任務,而不是以 503 失敗。無法繼續的要求會傳回 422 beneficial_owner_required,並附上說明,要求新增一位已申報或至少持有 25% 所有權的個人關聯方。請參閱股東、UBO 與控制人員。
  • 商家面板的任務表現在會顯示每個要求的主體與功能範圍,讓您了解合規要求涵蓋的對象與內容。請參閱功能與要求。
  • 商家面板中的行業分類欄位現在在客戶檔案與要求任務上提供可搜尋的 NAICS 代碼。請參閱KYB 工作流程。

變更

  • 與進行中的銀行設定衝突的銀行詳細資料提交現在會傳回 409 ops_rail_handoff_conflict。請保留已上傳的文件 ID,並在衝突解決後重試同一提交,而不是重新上傳文件。請參閱錯誤與重試。
  • 未預告的穩定幣存入客戶錢包的最低金額現在為 1 個單位,而不是 10 個。更小的存款仍會被視為粉塵。請參閱接收資金。
  • Webhook 設定現在按環境隔離。Webhook 入口網站會以您發起要求的環境為範圍開啟,因此沙盒與正式環境端點不再共用設定。請參閱Webhook。
  • 商家面板現在會根據客戶的 v3 功能推導可用的入金方式,因此帳戶設定只會提供客戶有權使用的方式。請參閱帳戶。
  • RFI 表單現在會以更簡短、清楚的提示收集符合資格的受益所有人,RFI 歷程則以生命週期里程碑的形式顯示。請參閱文件要求。

移除

  • 新增入金方式時,商家面板不再提供 Fedwire。現有 Fedwire 帳戶仍可讀取。請參閱帳戶。

修正

  • 未預告的 USDT 存入客戶錢包現在會被辨識並結算,而不是被忽略。
  • 您已提交的佐證現在會沿用到需要同一項目的其他任務,因此不會向客戶重複索取同一份文件。
  • 重新要求功能不再捨棄已就緒的銀行通道,因此已核發的帳戶詳細資料保持穩定。
  • 商家面板中的銀行指令檢視現在會顯示完整詳細資料,包括 SWIFT 地址與目標錢包地址。
  • RFI 表單現在會顯示提交驗證錯誤、在提交前驗證法律形式描述,並接受多個企業網站。
  • 您現在可以在提交前編輯 RFI 表單中的關聯方草稿。
  • 已取消的合規要求不再出現在商家面板任務清單中。
  • 文件審查狀態在商家面板中再次正確顯示。

2026-08-24

版本: v3

新增

  • 客戶範圍內託管的驗證與服務條款工作階段現在包含具權威性的 action 物件。請依照其 available 或 unavailable 類型處理;對於可用動作,頂層的 url 與 expiresAt 欄位仍保留為相容性鏡像。請參閱功能與要求。
  • 沙盒錢包加值現在會傳回可透過 GET /v3/transfers/{transferId} 讀取或透過 GET /v3/transfers 列出的轉帳 ID。它們會顯示為已完成的傳入穩定幣存款。請參閱在沙盒中測試。

變更

  • 商家面板中用於卡片與 Apple Pay 的 First pay-in 引導現在要求客戶擁有 Polygon 錢包。請先建立該錢包,再開始引導。請參閱帳戶。
  • 新要求與公開回應使用 sepa 作為方法與功能的標準名稱。sepa_instant 輸入別名及先前儲存的資源仍相容,但公開回應會使用 sepa。請參閱帳戶。
  • 新的 Faster Payments 功能、已發行帳戶與報價要求已不可用。現有帳戶、報價與轉帳仍可讀取。請參閱帳戶。
  • KYB 第一頁不再收集代表人的出生日期。股東出生日期仍是獨立要求。請參閱KYB 工作流程。
  • RFI 文件參照現在除了 image/jpeg 外,也接受 MIME 別名 image/jpg。請參閱文件要求。
  • 商家面板中的任務歷程現在會顯示不含修訂計數器、易於閱讀的稽核軌跡。請參閱功能與要求。

移除

  • 商家面板不再提供新的 UAEFTS 帳戶設定。現有 UAEFTS 帳戶仍可讀取。請參閱帳戶。

修正

  • 審查人員新增文件提交欄位時,RFI 表單會保留現有輸入,因此重新提交時不會遺失先前的回答。
  • 商家面板可從可用動作繼續託管的合規工作階段,而不會捨棄有效連結。
  • 託管的服務條款連結現在適用於 API 傳回的所有任務範圍。
  • 在商家面板中要求 Payment Access 後,面板會開啟該要求傳回的受理任務,而不是較早要求中的任務。
  • 商家面板的 KYB 示範現在會要求目前的必填欄位。
  • 報價若將來源錢包重複用作 destinationId,現在會在開始任何供應商工作前傳回可採取行動的 422 quote_direction_invalid 詳細資料。請參閱報價與轉帳。
  • API 現在會以 400 錯誤拒絕格式錯誤的查詢字串編碼,而不是在未提示的情況下正規化要求。請參閱錯誤與重試。
  • POST /v3/customers/{customerId}/documents 現在會以 400 錯誤拒絕空白、非 multipart 或格式錯誤的要求本文。

2026-08-17

版本: v3

新增

  • 在 OpenAPI 規範中發布 v3 Problem Details 目錄,讓整合方可以直接從 schema 對應錯誤回應。 Errors.
  • 為 v3 帳戶 webhook 事件新增 customerId,讓您無需後續讀取即可將帳戶活動關聯至擁有的客戶。請參閱 Webhook。
  • 商家後台完整支援 V3 個人檔案欄位,讓入駐操作人員可以審核並編輯透過 v3 API 收集的每個 KYC 欄位。請參閱客戶入駐。
  • 發布 v3 開發者遷移指南。請參閱遷移至 v3。

變更

  • 客戶與帳戶的國家代碼在寫入時現在會驗證為已指派的 ISO 3166-1 alpha-2 值。讀取時容許舊有儲存值,讓現有紀錄仍可繼續解析。請參閱帳戶與錢包。
  • USDC 的可用性現在依目的地網路限定,因此報價與轉帳只會在目的地實際支援的網路上提供 USDC。
  • Capability.ready 表示權限已獲核准,並不表示帳戶已核發。請使用 accountProvisioning 追蹤帳戶核發狀態:not_applicable、not_started、in_progress、issued 或 failed。
  • 現在接受來自 iPhone 的 HEIC 上傳作為身分與地址文件。

修正

  • 重新執行已消耗的報價現在會回傳 409 quote_execution_consumed,而非通用錯誤。請參閱報價與轉帳。
  • 轉帳清單讀取與報價金額讀取在大量歷史結果上不再回傳 500。
  • 個人客戶的關聯方讀取不再回傳 404。
  • 商家後台中的驗證連結列現在每一列都會顯示 Open 動作,且每個錢包基礎設施任務連結都會在需求視圖中呈現。