Swipelux API 更新日志与版本说明

​

新增

• 收款方目的地接受 pix 和 pix_safe 类型，用于在巴西进行 BRL 出金。Pix 目的地向 Pix 密钥付款。Pix Safe 目的地向通过持有人的 CPF 或 CNPJ、银行的 ISPB 代码、支行和账号识别的银行账户付款。两者都需要客户已就绪的 Pix 能力（pix_pooled），其出金由 USDC 提供资金，且不收取开发者费用。请参阅收款方和发送资金。
• GET /v3/customers/{customerId}/tasks/{taskId} 接受带有文档要求 ID 的 documentCandidatesFor，对于有替代选项的要求，还接受 documentAlternativeKey。此时响应会在 data.documentCandidates 中列出客户已上传且可满足该要求的文件，并附带任何 missingMetadata 或 conflictingMetadata。请提交候选文件的 documentId 并附上缺失的 documentMetadata，而无需重新上传文件。该查询需要 accounts:read 和 customers:read，无效的选择会返回 400 validation_error。

​

变更

• GET /v3/webhooks/portal 返回一个在一小时后过期的门户 URL，并带有 Cache-Control: no-store。使用具有 webhooks:write 的 API 密钥时，门户会显示端点签名密钥，并可管理端点、重试投递以及重放投递。仅具有 webhooks:read 时，门户只显示投递记录。请参阅Webhook。
• Citi（citibank）仅向企业客户提供。所有企业都保留共享 Citi，具名 Citi 仅向在美国境外注册的企业提供。当某客户不提供 Citi 时，支持列表会省略它，指定它会返回 422 capability_institutions_unsupported，仅由 Citi 提供的方式会被列为 disabled。未指定 institutions 的请求会在其余银行中进行选择。现有申请和账户保持不变。
• 具名 CFSB（cfsb）能力仅向美国客户提供：在美国注册的企业以及居住在美国的个人。对于其他客户，支持列表会省略具名 CFSB，指定它会返回 422 capability_institutions_unsupported。未指定 institutions 的请求会在其余银行中进行选择。共享 CFSB、国家未知的客户以及现有申请保持不变。
• Lead Bank（lead_bank）的具名 ACH、Wire 和 SWIFT 能力仅向 Lead Bank 能够根据其法律形式和所在国家完成入驻的客户提供。对于其他客户，支持列表会省略 lead_bank，指定它会返回 422 capability_institutions_unsupported。Lead Bank 已完成入驻的客户，以及未完成请求中已指定 lead_bank 的能力，会保留它。现有申请和账户保持不变。
• RTP 仅提供共享方式。没有任何银行向新请求提供 rtp_named，因此支持列表会将其显示为 disabled。对于未持有 rtp_named 的客户，针对它且指定了银行的能力请求或任务预览会返回 422 capability_institutions_unsupported，未指定 institutions 的则返回 422 capability_variant_unavailable。共享 RTP（rtp_pooled）由 Citi 提供，因此只有企业客户可以申请。
• 针对个人和最终受益人的新身份证件请求可以设置 constraints.identityMetadataRequired: true，此时每个文件都需要在 documentMetadata 中提供其证件号码和签发国家。针对企业地址证明和所有者居住证明的新请求可以设置 constraints.maxIssueAgeDays: 90，此时每个文件都需要提供其签发日期。现有任务保留其原有要求，因此请读取每个任务请求上的约束条件。
• 针对企业注册请求（其 profilePointer 为 /business/registration）的任务答案需要同时提供管辖国家、注册号码以及早于提交日期的成立日期。该请求的 valueSchema 公布了此规则，部分答案会返回 400 validation_error。
• 托管验证完成后，对于结构化值（例如地址或税务标识符）的档案要求，Swipelux 仅在托管答案通过与直接答案相同的 schema 和约束检查时才予以接受。否则该要求保持未完成状态，您需要通过 POST /v3/customers/{customerId}/tasks/{taskId}/submissions 提交该值。因这一原因被 Swipelux 退回到 action_required 的要求会带有 reviewFeedback.code: hosted_profile_direct_submission_required。已处于 satisfied 的任务保持其状态。请参阅能力与要求。
• 被托管验证拒绝的任务，在该验证决定后来被撤销时，可以脱离 rejected 状态。随后它会变为 satisfied，或在新的 revision 下变为 action_required，并重新开放新决定未回答的要求。这些要求之前的提交仍为 rejected，因此请重新提交这些答案。请参阅迁移到 v3。
• 收款方目的地的 type 现在是开放枚举。本参考的早期版本将其描述为封闭枚举，因此请更新任何会拒绝或丢弃未知类型的客户端。目的地响应和 destination.status_changed 事件现在可能包含 pix 和 pix_safe，并且以后可能新增更多类型。
• 收款方创建和更新请求（包括嵌套的 address）会忽略未定义的字段，而不是返回 400 validation_error。在创建请求中，属于另一种收款方类型的名称或行业字段仍会返回 400，在 PATCH /v3/customers/{customerId}/recipients/{recipientId} 中的 type 和 externalId 也是如此。不包含任何可识别字段的 PATCH 会返回 400 validation_error，而不是 200。
• 对于仅要求提供文档的符合条件的会话，其验证链接现在会打开由 Swipelux 托管的文档上传页面。链接本身保持不变，其他会话仍会打开托管验证流程。
• 个人客户和关联方人员的 employment.occupation 最多接受 255 个字符。
• 当资料值或任务答案包含 Swipelux 表单链接（例如 RFI、客户请求或转账追踪链接）时，POST /v3/customers, PATCH /v3/customers/{customerId}, POST /v3/customers/{customerId}/related-parties, PATCH /v3/customers/{customerId}/related-parties/{relatedPartyId} 和 POST /v3/customers/{customerId}/tasks/{taskId}/submissions 返回 400 validation_error。这不适用于 externalId 或 metadata。每个被拒绝的值都会出现在 errors[] 中，带有 code: public_form_link 及其 JSON Pointer，且响应绝不会重复该链接。请改为直接发送信息本身。请参阅错误与重试。

​

修复

• 出金报价和转账响应会将 USDC 或 USDT 源金额保留到小数点后六位，例如 4009.711365 而不是 4009.71。法币金额保留两位小数。创建或读取稳定币源金额超过两位小数的出金时，不再返回 500。
• POST /v3/customers/{customerId}/capabilities/{capabilityId}/cancel 参考现在按实际行为描述取消操作。您可以取消处于 ready 的能力，stablecoin_transfers 能力无法取消，取消只会终止该能力本身，其申请会保留各自的状态、任务和审批。
• 在 institutions 中列出银行代码而非公开机构 ID（例如用 citi 代替 citibank）的能力请求或任务预览，会返回列出可用 ID 的 422 capability_institutions_unsupported，而不是 503 kyc_configuration_unavailable。
• 针对没有任何银行向该客户提供的方式（支持列表将其显示为 disabled）的能力请求或任务预览，会返回带有 retryable: false 的 422 capability_variant_unavailable，而不是 503 kyc_configuration_unavailable，除非客户已持有该能力。
• documentCandidates 不再列出 Swipelux 从已完成的托管验证中保留的文件，这些文件您无法读取或下载。引用此类文件的任务答案会返回 400 invalid_document_reference，与未知文档相同。

​

新增

• GET /v3/customers 接受 include=documentRequirements。此时每条客户摘要都会报告仍有多少必需文档尚未提交，与能力就绪状态无关。可组合使用为 include=capabilities,documentRequirements。请参阅客户。
• 商户面板的 Webhooks 页面在端点菜单中新增 Replay missed events。它会重新发送端点在过去 13 天内从未收到的事件，且不会重复发送同一事件。请参阅Webhook。
• 商户面板的 Settings 页面新增 Compliance 部分。所有者和管理员可以设置合规电子邮箱，并选择在 Swipelux 要求提供某位客户的更多信息时是否接收电子邮件。
• 商户可以直接在商户面板的 KYB 页面上回复针对自身的 KYB 合规请求。

​

变更

• 银行受理完成后，客户和关联方更新不再返回 409 field_conflicts_with_completed_intake。更新会被保存，每个新的银行申请都会按照自身要求检查最新的客户档案。
• 当能力现有的银行路由无法安全更新时，能力请求会返回 409 capability_route_header_conflict。重试前请联系 Swipelux 支持团队。
• 当 institutions 指定了该能力不提供的银行时，GET /v3/customers/{customerId}/capabilities/{capabilityId}/tasks-preview 会返回 422 capability_institutions_unsupported，与能力请求的行为一致。
• 在沙盒中，ACH、Wire 和 SWIFT 能力仅由 JPMorgan Chase 提供。省略 institutions 的请求会选择 jpmorgan，指定其他银行会返回 422 capability_institutions_unsupported。生产环境路由保持不变。请参阅在沙盒中测试。
• 当模拟案例无法达到所请求的状态时，强制设置沙盒能力状态会返回 409 capability_status_blocked 并附带 statusReason。重复执行已生效的强制设置会返回 200，且状态不变。请参阅在沙盒中测试。
• 对于由运营团队或其他工作流拥有的任务,POST /v3/sandbox/tasks/{taskId}/review 会返回 409 task_not_sandbox_reviewable。来自 POST /v3/sandbox/tasks 的任务以及 Swipelux 收集的能力受理任务仍可审核。参见在沙盒中测试。
• 当账户仍在银行预配期间更改结算设置时，PATCH /v3/customers/{customerId}/accounts/{accountId} 会返回 409 account_provisioning_unresolved。请在预配完成后重试。请参阅错误与重试。
• POST /v3/transfers 可能返回 409 quote_execution_evidence_conflict。请创建新的报价并执行。请参阅错误与重试。
• 商户面板的 Pay out 抽屉会显示完整的目的地详情，通过切换开关隐藏账号和钱包地址，并显示每种付款方式的预计到账时间。
• 商户面板将银行账户并入客户的 Payment access 标签页，并提供列出每家银行的任务卡片。Documents 标签页已移至 Profile。
• 在商户面板中开设具名银行账户现在只需一个步骤，并会列出每家银行的币种、方式和入驻时间。请参阅账户。
• 因审核而被暂停的银行账户在商户面板中显示为 On hold，并显示账户 ID 和 Contact support 操作。
• 当 Swipelux 正在准备提交申请且尚未开始审核时，处于 pending 的能力现在会报告 statusReason.code: preparing_submission，而不是 review_in_progress。两个代码都使用 resolution: wait。在两者之间切换时状态仍为 pending，因此不会发送 capability.status_changed 事件。现有能力会在下一次重新评估时采用新代码。请参阅能力与要求。
• 商户面板中客户 Payment access 标签页上的 Shared methods 表格，对于能力报告 preparing_submission 的共享方式，会显示 In preparation 而不是 In review。
• 能力的 applications 列表现在仅显示其当前申请，适用于能力读取（包括 GET /v3/customers/{customerId}/capabilities/{capabilityId}/applications）、能力申请响应以及 capability.status_changed 事件。被较新申请替换的申请仍会出现在 GET /v3/customers/{customerId}/applications 中，其中 supersededByApplicationId 指明其后继申请。被替换申请的未完成任务仍计入能力的 openTaskIds。能力的状态和 openTaskIds 不会改变，因此此变更本身不会发送任何 webhook 事件。请参阅能力与要求。

​

修复

• 在银行批准之前，针对同一已签发账户发送的第二个 allowPending 请求会返回 409，并在 holder.accountId 中指明正在等待的账户，而不是返回 500。请参阅发行银行账户。
• 取消能力现在会关闭仍在等待银行批准的已签发账户请求，因此之后在同一银行发起的请求会重新开始。
• 重新请求所有银行案例均被拒绝的已取消能力时，只会发布一个从 canceled 开始的 capability.status_changed 事件。
• 在银行先前的申请被归档后重新请求该银行，现在会提交新的申请。
• 一旦对应能力显示为 ready，即可添加收款方目的地，而不再返回 409 rail_not_ready。请参阅收款方。
• 在您首次打开商户面板的 Webhooks 页面之前发送的 Webhook 事件现在会被保留，因此您可以将其重放到新的端点。
• 商户面板中的任务截止日期会以您所在的时区显示；当没有未完成项时，银行审核抽屉会显示 All requirements submitted。

​

新增

• POST /v3/quotes 现在接受可选的 institutionId，用于为加密货币到法币的出金报价选择已获批准的银行通道。省略该字段则保持自动路由。选择对该出金不可用的银行会返回 422 bank_not_supported_for_customer，在其他任何报价类型中发送 institutionId 会返回 400 validation_error。请参阅发送资金。
• POST /v3/customers/{customerId}/accounts 上签发银行账户的请求接受 institution，用于将账户固定到某一家银行且不进行回退；并接受 allowPending: true，用于在该银行的申请仍待批准时保存请求。allowPending 需要同时提供 institution。已保存的请求会报告其所属的 applicationId。请参阅发行银行账户。
• 商户面板新增原生 Webhooks 页面，用于管理端点。请参阅Webhook。
• 商户面板新增 Pay in 抽屉，包含已命名的银行账户、加密货币入金和审核步骤。
• 商户面板的 Pay out 流程会在来源选择器中显示钱包余额，新增 Max 金额选项，并包含审核步骤。
• 商户面板中的客户档案新增 Recipients & destinations 标签页。
• 任务要求可以包含简短的 title 标题。请求的 prompt 仍承载指导说明。请参阅能力与要求。

​

变更

• 共享 Wire 通道上的电汇入金报价现在要求至少 20 美元。低于所在通道最低金额，或金额过小、不足以支付转账费用的报价会返回 422 amount_not_deliverable，而不是通用的报价失败。请参阅接收资金。
• Webhook 门户现在按资源对 v3 事件类型进行分组，并显示每个事件的负载架构和示例。旧版事件类型显示在单独的 Legacy 分组中，并标记为已弃用。已订阅这些事件类型的端点会继续收到它们；新订阅请使用 v3 事件类型。请参阅Webhook。
• 沙盒充值现在会发出 transfer.created 和 transfer.state_changed Webhook 事件。请参阅在沙盒中测试。
• 当客户已拥有处于活跃状态的已签发账户时，accountProvisioning 现在会报告 issued。请参阅能力与要求。
• 商户面板中的银行账户详情会在抽屉中打开，并显示银行徽标。请参阅账户。
• 商户面板将资金流动标记为 Pay in 和 Pay out，保持登录状态六小时，并通过电子邮件将帮助请求发送给 Swipelux 支持团队。
• 在接受直接提交的受理任务中，已由客户档案或已上传文档支持的符合条件的要求会自动进入 in_review。请参阅能力与要求。

​

修复

• 重新请求已取消的能力不再因已被取代的申请记录或过时的要求而失败。
• 以已停用的 Fedwire ID 存储的能力现在读取为 wire，而不是返回 500。

​

新增

• GET /v3/customers/{customerId}/applications 列出客户的申请案例，包括针对每个案例请求的能力以及其批准所覆盖的能力。在一家银行获得的一次批准可以覆盖多项能力。保留的历史案例会通过 supersededByApplicationId 指向其后继案例。该列表支持游标分页和 updatedAfter。请参阅能力与要求。
• 对于基于申请案例的能力，POST /v3/customers/{customerId}/capabilities/{capabilityId} 的响应包含 selectedApplicationId。它标识该请求复用的现有申请案例，或其新开启的案例。请参阅能力与要求。
• 由 GET /v3/institutions 和支持的能力列表返回的机构包含可为空的 logoUrl。可用时使用它显示银行品牌标识，为 null 时回退为显示机构名称。请参阅能力与要求。
• 美元 SWIFT 出金现已可用。SWIFT 出金最低需要 100 美元。商户面板会收集收款方的 SWIFT 银行指令。请参阅发送资金。
• 已签发银行账户可以使用具名收款详情通过 SWIFT 收款。请参阅发行银行账户。
• USDT 现在支持作为 ACH 和 Wire 出金的来源。请参阅发送资金。
• 已签发银行账户接受值为 USDC 或 USDT 的 settlement.currency，用于选择交付到结算钱包的稳定币，与钱包账户币种无关。省略该字段则继续以钱包的币种结算。请参阅发行银行账户。
• SWIFT 银行账户和收款方目的地接受 bankCity、bankState、bankPostalCode 和 bankAddressLine2，以及可选的 beneficiaryTaxId、beneficiaryPhoneNumber、ifscBranchCode、paymentCode 和中转银行详情。请参阅发送资金。
• 当银行提供分开的 ACH 和 Wire 路由号码时，已签发银行账户详情会包含 achRoutingNumber 和 wireRoutingNumber，并包含收款银行的 bankLogoUrl。请参阅发行银行账户。
• capability.created Webhook 事件包含 applicationId 以及值为 requested 或 approval 的 origin，便于您区分自己请求的能力和由批准覆盖的能力。请参阅Webhook。
• 要求请求可以声明用于校验的 constraints.format，例如 http_url、us_ssn、us_ein 或 bank_industry_classification。请参阅能力与要求。

​

变更

• 商户面板中的银行账户创建现在从选择银行开始，银行账户会显示分开的 ACH 和 Wire 路由号码。请参阅账户。
• network 枚举现在包含 solana。这是一个开放枚举，因此请容忍您无法识别的网络值。请参阅账户。
• 如果任务的剩余要求需要直接提交，为该任务打开托管验证链接会返回 409 verification_session_not_allowed。请改为以任务提交的方式提交这些要求。请参阅错误与重试。
• 归档预配尚未完成的已签发账户会返回 409 account_provisioning_unresolved。请在预配完成后重试。请参阅错误与重试。
• 新的具名银行账户请求会在账户创建后立即排队等待预配，而不是等到下一次客户刷新。请参阅发行银行账户。

​

移除

• 新账户不再提供共享的 SWIFT 收款详情。请改用具名 SWIFT 收款详情。请参阅发行银行账户。

​

修复

• 出金转账读取现在会返回报价中的收款方。
• 归档现有 ACH 账户后再创建 ACH 账户不再返回 409，已归档的待处理账户请求也不再占用账户名额。
• 本币入金报价上的银行费用现在以正确的法币币种报告。

​

新增

• GET /v3/webhooks/{webhookId} 可读取单个 Webhook 端点及其 events 选择。请参阅Webhook。
• 任务要求现在会为档案字段（包括必填地址字段）发布 allowedValues 和 JSON Schema valueSchema。国家/地区字段会将 valueType 或 itemValueType 报告为 country，即 ISO 3166-1 alpha-2 代码。您无需硬编码即可渲染输入项和选项。请参阅能力与要求。
• 现有的 Tron 钱包现在可以向客户的外部钱包账户发送 USDT，转账读取会包含 Tron 交易的区块浏览器链接。无法在 Tron 上签发新钱包。请参阅发送资金。
• 任务要求可以声明 requiredWhen（仅当指定的是/否回答匹配时才需作答）、profileAssertion（us_person）和 ownershipPolicy，文档请求可以设置 identityMetadataRequired 和 maxIssueAgeDays。任务回答接受针对所引用文档的 documentMetadata（idNumber、issuingCountry、issuedOn），任务读取会在 conditionValues 中返回已审核的控制性回答。请参阅能力与要求。
• 文档要求可以列出 acceptedDocumentSets，关联方要求除 beneficial_owner 外还可以要求 associated_person 或 control_person 资格。请参阅能力与要求。
• 转账 correction 对象现在也涵盖已注资但失败的出金：kind: funding_failure，附带 recover_source_funding 补偿操作、值为 unknown 或 reported 的 recoveryStatus，以及 USDT 入账输出。请参阅报价与转账。

​

变更

• PATCH /v3/webhooks/{webhookId} 现在接受端点已订阅的旧版事件类型，因此您可以在添加 v3 事件类型时保留它们。events 会替换完整的选择，因此请包含您想保留的每一种事件类型。添加端点原本没有的旧版事件类型会返回 400 validation_error。请参阅Webhook。
• 收款方和账户上的银行标识符会在保存前进行校验。请参阅收款方。
• 当能力是在较早的入驻模型下创建时，能力请求、任务提交和沙盒状态变更现在会返回 409 capability_application_stale，而不是 500。请参阅错误与重试。
• 公开的 RFI 页面现在是一个连续的表单。它支持关联人员，并为每个人收集一个税号。请参阅文档要求。
• 当付款超过客户在银行的剩余每日或每月额度时，报价和转账会返回 409 customer_bank_limit_exceeded；无法检查该额度时会返回 503 customer_bank_limits_unavailable。当出金无法从其报价启动时，转账会返回 409 payout_execution_unavailable。请参阅错误与重试。
• 与已完成的银行受理相冲突的客户和关联方更新会返回 409 field_conflicts_with_completed_intake，并附带 taskId 和 fields。

​

修复

• 已取消的能力历史仍可读取。
• 电汇出金在商户面板的交易列表中能够正确显示和筛选。

​

变更

• POST /v3/transfers 和转账读取现在使用 checkoutMethod 而非 paymentMethod 来预选银行卡结账方式，并接受 card、apple_pay、google_pay、cash_app、sepa 和 blik。该列表是开放的，可能会增加。paymentMethod 不再被识别；仍发送该字段的请求会被视为省略了它。sepa 和 blik 是银行卡结账内部的付款选项，而不是 Swipelux 的能力。请参阅接收资金。

​

新增

• POST /v3/transfers 现在接受可选的 paymentMethod（card、apple_pay 或 google_pay），用于银行卡报价。当请求的方式对客户及其设备可用时，托管结账会以该方式打开；转账读取会回显该请求，报价的金额和费用保持不变。请参阅接收资金。
• GET /v3/customers/{customerId}/capabilities/{capabilityId}/tasks-preview 接受 institutions，用于预览支持的能力列表所返回的特定银行的任务。请参阅能力与要求。

​

变更

• 银行卡报价现在会反映结账费用和实际交付的 USDC 净额。请参阅接收资金。
• 被拒绝的出金报价现在返回具体的问题代码，而不是通用失败：quote_amount_out_of_range、quote_volume_limit_exceeded、quote_source_network_unsupported 或 quote_failed；当报价可稍后重试时返回 503 quote_temporarily_unavailable。请参阅错误与重试。

​

修复

• 银行卡报价不再因费用四舍五入而失败。
• 当问卷答案包含多余空格时，重新打开托管 KYC 链接不再返回 409 kyc_process_conflict。
• 商户面板中卡住的通行密钥提现确认现在可以恢复。

​

新增

• POST /v3/customers/{customerId}/documents 现在还接受携带 storageKey、fileName 和 type 的 application/json 请求体。storageKey 必须是通过先前的直接上传流程暂存的、客户范围内的新鲜引用，且该上传会经过与 multipart 上传相同的大小和文件签名校验。请参阅迁移到 v3。
• GET /v3/customers/{customerId}/documents/{documentId}/download 会为处于活跃状态的客户文档返回一个下载 url。该 URL 在一小时后过期，并以附件形式提供文件。已归档、未知或跨客户的文档会返回 404。请参阅能力与要求。
• 为没有受益所有人的企业请求能力时，现在会创建用于添加受益所有人的受理任务，而不是以 503 失败。无法继续的请求会返回 422 beneficial_owner_required，并附带说明，要求添加一位已申报或至少持股 25% 的个人关联方。请参阅股东、UBO 与控制人。
• 商户面板的任务表现在会显示每个请求的主体和能力范围，让您了解合规请求涉及的对象和内容。请参阅能力与要求。
• 商户面板中的行业分类字段现在在客户档案和要求任务上提供可搜索的 NAICS 代码。请参阅KYB 工作流程。
• 银行入金指令可以包含 bankName、bankAddress、accountHolderName 和 accountHolderAddress。请将它们与其他银行信息一起显示。请参阅接收资金。
• POST /v3/transfers 接受可选的 redirectUrl，用于在银行卡或 Apple Pay 托管结账后将客户带回您的应用。到达该 URL 并不能确认已完成；请使用转账读取或 Webhook。请参阅接收资金。
• 由 v3 Rule 创建的转账会以 origin: rule 出现在转账读取和列表中，并像其他转账一样发出 transfer.state_changed 事件。可使用 GET /v3/transfers?origin=rule 筛选它们。请参阅报价与转账。
• 客户和关联方上的身份证件接受 sideApplicability（front_only、front_and_back 或 unknown），任务可以将 type、number、issuingCountry、issuingRegion、issuedOn、expiresOn 和 doesNotExpire 等身份证件详情作为回答收集。请参阅能力与要求。

​

变更

• 与正在进行的银行设置冲突的银行详情提交现在会返回 409 ops_rail_handoff_conflict。请保留已上传的文档 ID，并在冲突解决后重试同一提交，而不是重新上传文档。请参阅错误与重试。
• 未预告的稳定币入金到客户钱包的最低金额现在为 1 个单位，而不是 10 个。更小的入金仍被视为粉尘。请参阅接收资金。
• Webhook 配置现在按环境隔离。Webhook 门户会以您发起请求的环境为范围打开，因此沙盒和生产端点不再共享设置。请参阅Webhook。
• 商户面板现在根据客户的 v3 能力推导可用的入金方式，因此账户设置只会提供客户有权使用的方式。请参阅账户。
• RFI 表单现在使用更简短、清晰的提示收集符合条件的受益所有人，RFI 历史则以生命周期里程碑的形式显示。请参阅文档要求。
• 没有明确截止日期的未完成任务现在默认将 dueAt 设为创建后 31 天。请参阅能力与要求。

​

移除

• 添加新的入金方式时，商户面板不再提供 Fedwire。现有 Fedwire 账户仍可读取。请参阅账户。

​

修复

• 未预告的 USDT 入金到客户钱包现在会被识别并结算，而不是被忽略。
• 您已提交的证明材料现在会沿用到需要同一项目的其他任务，因此不会向客户重复索要同一份文档。
• 重新请求能力不再丢弃已就绪的银行通道，因此已签发的账户详情保持稳定。
• 商户面板中的银行指令视图现在显示完整详情，包括 SWIFT 地址和目标钱包地址。
• RFI 表单现在会显示提交校验错误、在提交前校验法律形式描述，并接受多个企业网站。
• 您现在可以在提交前编辑 RFI 表单中的关联方草稿。
• 已取消的合规请求不再出现在商户面板任务列表中。
• 文档审核状态在商户面板中再次正确显示。

​

新增

• 客户范围内托管的验证和服务条款会话现在包含权威的 action 对象。请遵循其 available 或 unavailable 类型；对于可用操作，顶层的 url 和 expiresAt 字段继续作为兼容性镜像。请参阅能力与要求。
• 沙盒钱包充值现在返回可通过 GET /v3/transfers/{transferId} 读取或通过 GET /v3/transfers 列出的转账 ID。它们显示为已完成的稳定币入金。请参阅在沙盒中测试。
• 当转账完成后其资金被退回或冲正时，转账读取会包含 correction 对象。它会报告更正的 kind、规范化的 providerStatus、任何 providerShortfall，以及 Swipelux 采取的 compensatingIntent。请参阅报价与转账。

​

变更

• 商户面板中用于银行卡和 Apple Pay 的 First pay-in 引导现在要求客户拥有 Polygon 钱包。请先创建该钱包，再开始引导。请参阅账户。
• 新请求和公开响应使用 sepa 作为规范的方法和能力名称。sepa_instant 输入别名及以前存储的资源仍然兼容，但公开响应使用 sepa。请参阅账户。
• 新的 Faster Payments 能力、发行账户和报价请求已不可用。现有账户、报价和转账仍可读取。请参阅账户。
• KYB 第一页不再收集代表的出生日期。股东出生日期仍是独立要求。请参阅KYB 工作流程。
• RFI 文档引用现在除 image/jpeg 外还接受 MIME 别名 image/jpg。请参阅文档要求。
• 商户面板中的任务历史现在显示不含修订计数器的易读审计记录。请参阅能力与要求。
• 报价和转账现在会在任何资金流动之前检查能力支持的方向。在能力不支持的方向上使用该能力会返回 422 capability_direction_unsupported，钱包之间的资金转移需要 stablecoin_transfers 能力。请参阅错误与重试。

​

移除

• 商户面板不再提供新的 UAEFTS 账户设置。现有 UAEFTS 账户仍可读取。请参阅账户。

​

修复

• 审核人员添加新的文档上传项时，RFI 表单会保留现有输入，因此重新提交时不会丢失之前的回答。
• 商户面板可从可用操作继续托管的合规会话，而不会丢弃有效链接。
• 托管的服务条款链接现在适用于 API 返回的所有任务范围。
• 在商户面板中请求 Payment Access 后，面板会打开该请求返回的受理任务，而不是先前请求中的任务。
• 商户面板的 KYB 演示现在会要求填写当前必填字段。
• 当报价将其来源钱包重新用作 destinationId 时，现在会在启动任何提供商操作前返回可操作的 422 quote_direction_invalid 详情。请参阅报价与转账。
• API 现在会对格式错误的查询字符串编码返回 400，而不是静默规范化请求。请参阅错误与重试。
• POST /v3/customers/{customerId}/documents 现在会对空、非 multipart 或格式错误的请求体返回 400。

​

新增

• 在 OpenAPI 规范中发布了 v3 Problem Details 目录，集成方可直接从架构中映射错误响应。参见 错误。
• 在 v3 账户 webhook 事件中新增了 customerId，让您无需再进行一次读取即可将账户活动与其所属客户关联。参见 Webhook。
• 商户面板中完整覆盖 V3 个人档案字段，入驻操作员可查看并编辑通过 v3 API 收集的每个 KYC 字段。参见 客户。
• 发布了 v3 的开发者迁移指南。参见 迁移到 v3。

​

变更

• 客户与账户的国家/地区代码在写入时现按已分配的 ISO 3166-1 alpha-2 值进行校验。读取时兼容遗留的存储值，因此现有记录仍可解析。参见 账户与钱包。
• USDC 可用性现按目的网络进行限定，因此报价与转账仅在目的地实际支持的网络上提供 USDC。
• 现在每个入驻流程都需要同意 Swipelux 服务条款。现有会话仍可继续。参见 客户。
• Capability.ready 仍然表示权限已获批准。使用 accountProvisioning 跟踪账户签发状态：not_applicable、not_started、in_progress、issued 或 failed。参见 能力与要求。
• 现已支持从 iPhone 上传 HEIC 作为身份和地址证明文件。
• 清除未完成任务仍需要的客户或关联方字段现在会返回 409 field_required_by_open_task，并附带造成阻塞的 taskId 和 fields，而不是可重试的冲突。请先完成或取消该任务，再更改这些字段。参见 错误与重试。

​

修复

• 重新执行已消费的报价现返回 409 quote_execution_consumed，而不是通用错误。参见 报价与转账。
• 大规模历史结果下的转账列表读取与报价金额读取不再出现 500。
• 并发的 KYC 重定向现在返回冲突而不是 404，因此重试可以顺利完成。托管重定向不再中途回滚，KYC 链接仍可继续使用。
• 个人客户的关联方读取不再返回 404。
• 含有无效钱包字段的 KYB 提交会在提交前被拒绝，且失败的同步不再在商户面板中显示为成功。
• 商户面板中的要求任务现在会将已提交的回答显示为已完成，单独跟踪条款操作，去除重复的文档文本，将已开始的 KYC 会话在完成前保持为待处理，并且在处理过期任务时不会破坏需求视图。
• 商户面板中的验证链接行现在每行都显示 Open 操作，每个任务链接都会在需求视图中渲染。