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 现在会对空、非 multipart 或格式错误的请求体返回 400。

2026-08-17

版本: v3

新增

  • 在 OpenAPI 规范中发布了 v3 Problem Details 目录,集成方可直接从架构中映射错误响应。 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 操作,每个钱包基础设施任务链接都会在需求视图中渲染。