> ## Documentation Index > Fetch the complete documentation index at: https://cobo.com/payments/llms.txt > Use this file to discover all available pages before exploring further. # 发布历史 ## 2026 年 07 月 | 功能 | 变更说明 | 发布时间 | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | | **资金管理** | (SDK v1.39.0) Bulk Send：`PaymentBulkSendItemValidationStatus` 枚举新增 `NotExecuted` 取值。[List bulk send items](/payments/en/api-references/payment/list-bulk-send-items) 响应中的 `validation_status` 可返回该值，表示该条目的校验未执行（例如在 `Strict` 模式下其他条目校验失败、整批在验证阶段被拒绝时）。 | 2026-07-01 | ## 2026 年 06 月 | 功能 | 变更说明 | 发布时间 | | ----------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | | **Webhook** | (SDK v1.38.0) 新增 Webhook 事件 `payment.account.balance.updated`（`PaymentAccountBalanceUpdate`），当支付账户某币种的可用余额发生变动时触发。负载包含账户信息（`source_account`、`source_id`、`source_type`）、`token_id`、变动金额 `amount`、`balance_before` / `balance_after`、`flow_direction` 及 `update_time`。详见 [Status and events](/payments/cn/guides/status-and-events)。
在 `payment.address.updated` Webhook 负载中新增 `merchant_id` 字段。 | 2026-06-25 | | **资金管理** | (SDK v1.39.0) 划转（Allocation）状态追踪：
・[List all batch allocations](/payments/en/api-references/payment/list-all-batch-allocations) 和 [Create batch allocation](/payments/en/api-references/payment/create-batch-allocation)：响应新增 `status` 字段（`Pending`、`Processing`、`Completed`、`PartiallyCompleted`、`Failed`）。
・[Get batch allocation information](/payments/en/api-references/payment/get-batch-allocation-information)：响应新增 `status` 字段。
・[List all allocation items](/payments/en/api-references/payment/list-all-allocation-items)：响应条目新增 `status` 字段（`Pending`、`Transferring`、`Completed`、`Failed`）。 | 2026-06-24 | | **资金管理** | (SDK v1.37.0) 新增 [List balance changes](/payments/en/api-references/payment/list-balance-changes) 操作，用于查询指定来源账户的余额变动记录。

Bulk Send 功能增强：
・[List bulk send items](/payments/en/api-references/payment/list-bulk-send-items)：响应中新增 `tx_hash` 字段，返回每条批量下发记录对应的链上交易哈希。
・[List all bulk sends](/payments/en/api-references/payment/list-bulk-sends)、[Get bulk send information](/payments/en/api-references/payment/get-bulk-send-information) 响应及 Bulk Send Webhook 通知（`payment.bulk_send.status.updated`）数据中新增 `commission_fee` 字段，返回本次批量下发所收取的手续费信息。 | 2026-06-09 | ## 2026 年 05 月 | 功能 | 变更说明 | 发布时间 | | --------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | | **资金管理** | (SDK v1.36.0) Bulk Send 功能增强：
・[Create bulk send](/payments/en/api-references/payment/create-bulk-send)：新增可选字段 `request_id`，用于幂等控制，防止重复提交。响应中同步返回 `request_id`。
・新增 [List all bulk sends](/payments/en/api-references/payment/list-bulk-sends) 操作，支持查询批量下发记录，可按 `request_id` 过滤。 | 2026-05-26 | | **资金管理（不兼容变更）** | (SDK v1.35.0) 以下已废弃的银行账户 API 操作已被永久移除，请改用[转出目的地](/payments/en/api-references/payment/create-destination)相关操作：
- 查询银行账户列表（`GET /payments/bank_accounts`）
- 更新银行账户（`PUT /payments/bank_accounts/{bank_account_id}`） | 2026-05-12 | | **收款** | (SDK v1.35.0) 充值模式付款方功能增强：
・[List payers](/payments/en/api-references/payment/list-payers) 响应新增 `custom_payer_id` 字段，即商户侧的用户唯一标识。
・新增 [List payer transactions](/payments/en/api-references/payment/list-payer-transactions) 操作，支持分页查询指定付款方的链上充值交易记录，可按 `custom_payer_id`、`merchant_id`、`token_id`、`transaction_hash` 等过滤。[List payers](/payments/en/api-references/payment/list-payers) 响应中的 `transactions` 字段已废弃，将在未来版本中移除。当前版本起，该字段最多返回最近 200 条交易，不再返回全部记录。 | 2026-05-12 | ## 2026 年 04 月 | 功能 | 变更说明 | 发布时间 | | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | | **资金管理** | (SDK v1.34.0) OffRamp 转出新增虚拟账户（VA）路由支持：
・[Estimate fees](/payments/en/api-references/payment/estimate-fees)：请求体新增 `transfer_via_va` 字段。设置为 `true` 表示通过虚拟账户转出至银行账户，`false` 表示直接转入银行账户。
・`RecipientInfo` Schema：转出响应中新增 `transfer_via_va` 字段，标识该笔转出是否通过虚拟账户路由。 | 2026-04-07 | | **退款** | (SDK v1.34.0) [Create refund link](/payments/en/api-references/payment/create-refund-link) 新增可选字段 `order_id`。您现在可以通过 `order_id` 或 `transaction_id` 指定要退款的订单；此前仅支持 `transaction_id`。 | 2026-04-07 | ## 2026 年 03 月 | 功能 | 变更说明 | 发布时间 | | ----------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | | **支付链接** | (SDK v1.33.0) 新增 [Create SDK link](/payments/en/api-references/payment/create-sdk-link) 操作，用于生成前端 SDK 初始化所需的 token 和 URL，便于开发者将 Cobo 支付界面嵌入 Web 应用中。 | 2026-03-24 | | **Webhook** | **(SDK v1.32.0)** 新增 Webhook 手动触发 API：`payments/webhooks/trigger` ，支持开发者在无需创建真实交易的情况下，手动触发 Payment 相关 Webhook 事件，便于集成测试 | 2026-03-12 | | **资金管理** | **(SDK v1.32.0)** `List merchant balances` 接口新增灵活查询支持，token\_id 与 merchant\_ids 参数现均为可选，支持按指定 token 或跨多个商户查询余额 | 2026-03-12 | | **转出目的地** | **(SDK v1.32.0)** Payout Destination 管理功能优化：
・**Create destination**：request 中新增 `bank_accounts[].country`、`bank_accounts[].city`；`bank_accounts[].intermediary_bank_info.bank_address` 变为选填
・**Get destination detail**：response 中新增 `bank_accounts[].country`、`bank_accounts[].city`
・**Create destination entry**：request 中新增 `bank_accounts[].country`、`bank_accounts[].city`；`bank_accounts[].intermediary_bank_info.bank_address` 变为选填
・**List destination entries**：response 中新增 `bank_accounts[].country`、`bank_accounts[].city`
・**Get destination entry information**：response 中新增 `bank_account.country`、`bank_account.city`
・**Update destination entry**：response 中新增 `bank_account.country`、`bank_account.city`；request 中 `bank_account.intermediary_bank_info.bank_address` 变为选填 | 2026-03-12 | | **报表** | **(SDK v1.32.0)** `Generate reports` 接口 新增报表类型枚举值 BulkSend，支持生成 Bulk Send 报表 | 2026-03-12 | ## 2026 年 02 月 本文记录 Cobo 支付解决方案的全部重要更新与即将上线的功能，助您及时掌握产品动态与升级信息。 | 功能 | 变更说明 | 发布时间 | | :---------------------- | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- | | **Cobo Payments AI 助手** | [Cobo Payments AI 助手](/payments/cn/guides/payments-ai-assistant)是嵌入在 Cobo Portal 中的智能对话助手，可帮助您完成初始配置、方案设计、回答问题与排查。 | 2026-02-05 | | **资金管理** | App 端新增支持[批量下发](/payments/cn/guides/bulk-send)功能。 | 2026-02-05 | | **SDK & API** | (SDK v1.31.0) Webhook 事件有如下调整：

- 新增以下事件：
　- `payment.transaction.external.created`
　- `payment.transaction.external.completed`
- 移除了 `payment.transaction.held` 事件
- `payment.status.updated` 调整为 `payment.order.status.updated`（**需重新订阅**）
　- 不再推送：`Processing`
　- 仅推送：`Completed` / `Expired` / `Underpaid`
- `payment.refund.status.updated`
　- 不再推送：`Processing`
　- 仅推送：`Completed` / `PartiallyCompleted` / `Failed`
- `payment.payout.status.updated` 增加了 `RejectedByBank` 状态 | 2026-02-05 | | **支持的链** | (SDK v1.31.0) 新增查询支持的代币：[List supported tokens](/payments/en/api-references/payment/list-supported-tokens)。 | 2026-02-05 | | **收款** | 创建支付订单时新增金额参数组合校验规则。使用 `pricing_currency`、`pricing_amount`、`payable_currency` 字段时，必须符合以下两种组合之一：

**方式一：按定价金额创建订单**
　- 必填：`pricing_currency`、`pricing_amount`、`payable_currency`
　- 不可填写：`payable_amount`

**方式二：按实际支付金额创建订单**
　- 必填：`payable_currency`、`payable_amount`
　- 不可填写：`pricing_currency`、`pricing_amount`

注意：`payable_currency` 在所有情况下均为必填。同时填写两种方式的参数，或不符合以上任一组合的请求，将被拒绝。

涉及的 API 操作：[Create pay-in order](/payments/en/api-references/payment/create-pay-in-order) | 2026-02-05 | ## 2026 年 01 月 | 功能 | 变更说明 | 发布时间 | | :--------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :--------- | | **收款 (不兼容变更)** | (SDK v1.30.0) 调用 [Create pay-in order](/payments/en/api-references/payment/create-pay-in-order) 创建支付订单时，`payable_currency` 现在为必填参数。未传入上述字段将导致请求校验失败，无法创建支付订单。请更新你的请求体，确保请求中包含以上字段。 | 2026-01-22 | | **支付链接 (不兼容变更)** | (SDK v1.30.0) 调用 [Create order link](/payments/en/api-references/payment/create-order-link) 创建支付链接时，`pricing_currency`、`pricing_amount`、`payable_currencies` 现在为必填参数。未传入上述字段将导致请求校验失败，无法创建支付链接。请更新你的请求体，确保请求中包含以上字段。 | 2026-01-22 | | **资金管理** | (SDK v1.30.0) 全新资金转出（Payout）API 操作，转出流程更加高效，无需区分资金来源（收款/充值模式）或指定订单，只需填写金额即可完成转出。进行加密货币转账时，支持[自动跨链](/payments/cn/guides/crypto-payouts)，可将分布在不同链上的同一代币一次性转出至一个目标地址。

涉及的 API 操作包括：
  - [Create payout](/payments/en/api-references/payment/create-payout)
  - [List all payouts](/payments/en/api-references/payment/list-all-payouts)
  - [Get payout information](/payments/en/api-references/payment/get-payout-information)

以下资金转出操作已废弃：
  - [Create settlement request](/payments/en/api-references/payment/create-settlement-request)
  - [List all settlement requests](/payments/en/api-references/payment/list-all-settlement-requests)
  - [Get settlement request information](/payments/en/api-references/payment/get-settlement-request-information)
  - [List all settlement details](/payments/en/api-references/payment/list-all-settlement-details)

上述操作目前仍可继续使用，但建议尽快迁移至新的 API 操作，以获得更好的资金转出体验。 | 2026-01-22 | | **资金管理** | (SDK v1.30.0) 新增批量下发（Bulk Send）API 操作，支持加密货币批量转账功能：
  - [Create bulk send](/payments/en/api-references/payment/create-bulk-send)
  - [Get bulk send information](/payments/en/api-references/payment/get-bulk-send-information)
  - [List bulk send items](/payments/en/api-references/payment/list-bulk-send-items) | 2026-01-22 | | **收款** | (SDK v1.30.0) 新增 [Batch Create Top-up Address](/payments/en/api-references/payment/batch-create-top-up-addresses) 操作，支持批量获取充值地址。 | 2026-01-22 | | **资金管理** | (SDK v1.30.0) [Estimate fees](/payments/en/api-references/payment/estimate-fees) 操作的 `fee_type` 枚举新增支持以下取值，用于预估各类资金转出方式的手续费：

  - `CryptoPayout`（加密货币转账）
  - `CryptoPayoutBridge`（加密货币转账，包含跨链操作）
  - `OffRampPayout`（Off-ramp 对接）

同时废弃了 `CryptoSettlement` 和 `OffRampSettlement` 取值。 | 2026-01-22 | | **资金管理** | （SDK v1.30.0） 为提升参数命名一致性与结果可读性，以下划转资金（Allocation）操作中的字段名称已更新，请您同步调整请求参数与返回结果的解析逻辑：

  - [Create batch allocation](/payments/en/api-references/payment/create-batch-allocation) 操作中的 `allocation_requests` 字段更新为 `allocation_params`。
  - [Get batch allocation information](/payments/en/api-references/payment/get-batch-allocation-information) 中的返回字段 `allocation_records` 已更名为 `allocation_items`。
   - **List all allocation records** 操作更名为 [List all allocation items](/payments/en/api-references/payment/list-all-allocation-items)，返回中的字段 `allocation_record_id` 更名为 `allocation_item_id`。

请您尽快完成字段名称更新，以确保资金划转相关功能在后续版本中的兼容性。 | 2026-01-22 | | **转出目的地** | (SDK v1.30.0) 以下操作已废弃，请使用转出目的地（[Destination](/payments/en/api-references/payment/create-destination)）相关操作。
  -[List all bank accounts](/payments/en/api-references/payment/list-all-bank-accounts)
  -[Create crypto address](/payments/en/api-references/payment/create-crypto-address)
  -[Delete crypto address](/payments/en/api-references/payment/delete-crypto-address)
  -[List crypto addresses](/payments/en/api-references/payment/list-crypto-addresses) | 2026-01-22 | ## 2025 年 12 月 | 功能 | 变更说明 | 发布时间 | | --------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | | **交易对手方** | (SDK v1.29.0) 新增[交易对手方](/payments/cn/guides/counterparties) API 操作，用于管理付款方信息：
  - [Create counterparty](/payments/en/api-references/payment/create-counterparty)
  - [List all counterparties](/payments/en/api-references/payment/list-all-counterparties)
  - [Get counterparty information](/payments/en/api-references/payment/get-counterparty-information)
  - [Update counterparty](/payments/en/api-references/payment/update-counterparty)
  - [Delete counterparty](/payments/en/api-references/payment/delete-counterparty)
  - [Create counterparty entry](/payments/en/api-references/payment/create-counterparty-entry)
  - [List counterparty entries](/payments/en/api-references/payment/list-counterparty-entries)
  - [Get counterparty entry information](/payments/en/api-references/payment/get-counterparty-entry-information)
  - [Delete counterparty entry](/payments/en/api-references/payment/delete-counterparty-entry) | 2025-12-29 | | **转出目的地** | (SDK v1.29.0) 新增[转出目的地](/payments/cn/guides/destinations) API 操作，用于集中管理资金转出时的目的地信息：
  - [Create destination](/payments/en/api-references/payment/create-destination)
  - [List all destinations](/payments/en/api-references/payment/list-all-destinations)
  - [Get destination information](/payments/en/api-references/payment/get-destination-information)
  - [Update destination](/payments/en/api-references/payment/update-destination)
  - [Delete destination](/payments/en/api-references/payment/delete-destination)
  - [Create destination entry](/payments/en/api-references/payment/create-destination-entry)
  - [List destination entries](/payments/en/api-references/payment/list-destination-entries)
  - [Get destination entry information](/payments/en/api-references/payment/get-destination-entry-information)
  - [Update destination entry](/payments/en/api-references/payment/update-destination-entry)
  - [Delete destination entry](/payments/en/api-references/payment/delete-destination-entry) | 2025-12-29 | | **报表** | (SDK v1.29.0) 新增报表 API 操作，用于生成和管理报表：
  - [Generate reports](/payments/en/api-references/payment/generate-reports)
  - [List all reports](/payments/en/api-references/payment/list-all-reports) | 2025-12-29 | | **资金管理** | (SDK v1.29.0) [List all bank accounts](/payments/en/api-references/payment/list-all-bank-accounts) 操作已废弃。 | 2025-12-29 | | **资金管理** | (SDK v1.28.0) 新增[划转 API](/payments/cn/guides/allocate-funds) 操作，用于在不同账户之间灵活分配资金：
  - [Get available allocation amount](/payments/en/api-references/payment/get-available-allocation-amount)
  - [Create batch allocation](/payments/en/api-references/payment/create-batch-allocation)
  - [Get batch allocation information](/payments/en/api-references/payment/get-batch-allocation-information)
  - [List all batch allocations](/payments/en/api-references/payment/list-all-batch-allocations)
  - [List all allocation records](/payments/en/api-references/payment/list-all-allocation-records) | 2025-12-18 | | **收款** | (SDK v1.28.0) [Create pay-in order](/payments/en/api-references/payment/create-pay-in-order) 和 [Create order link](/payments/en/api-references/payment/create-order-link) 字段简化：支持自定义应付金额，去除 `exchange_rate` 字段，并优化了部分字段命名，增强了可读性和易用性。金额字段的全局精度统一为 2 位小数，方便对账和资金管理。

[Create pay-in order](/payments/en/api-references/payment/create-pay-in-order)：
  - 新增字段：`pricing_currency`、`pricing_amount`、`payable_currency`、`payable_amount`。
  - 已废弃字段：`currency`、`order_amount`、`token_id`、`custom_exchange_rate`。

[Create order link](/payments/en/api-references/payment/create-order-link)：
  - 新增字段：`pricing_currency`、`pricing_amount`、`payable_currencies`、`payable_amounts`。
  - 已废弃字段：`currency`、`order_amount`、`token_ids`、`custom_exchange_rates`。 | 2025-12-18 | | **支付链接** | (SDK v1.28.0) 使用 [Create order link](/payments/en/api-references/payment/create-order-link) 创建订单支付链接时，新增 `return_url` 字段，现支持配置商户原购物页 URL。在用户支付成功或遇到异常时，可跳转回原购物页面，提升用户支付体验。 | 2025-12-18 | | **资金管理** | - 新增[划转](/payments/cn/guides/allocate-funds)功能，支持在不同账户之间手动分配资金。目前已支持通过 Payments App 操作，API 即将开放。
- 新增[账户](/payments/cn/guides/amounts-and-balances#账户)概念。账户为系统账本下管理的虚拟资金主体。详见[账户与资金分配](/payments/cn/guides/amounts-and-balances)。
- 简化了资金转出流程。转出时无需选择资金来源（收款或充值模式）或指定订单，只需直接填写金额，更加高效便捷。目前已支持通过 Payments App 操作，API 即将开放。详见[Off-Ramp 对接](/payments/cn/guides/fiat-payouts)和[加密货币转账](/payments/cn/guides/crypto-payouts)。 | 2025-12-12 | | **支付链接** | [订单支付链接](/payments/cn/guides/payment-link)全新改版：
- 全新视觉与交互设计
- 桌面端新增支持 Binance Wallet（EVM 及 Solana 链）
- 支持扫描含金额的二维码，自动填充转账金额
- 第三方钱包调用优化：调用流程简化、支持推荐前一次使用的钱包 | 2025-12-12 | | **交易对手方** | 新增[交易对手方](/payments/cn/guides/counterparties)功能，用于管理付款方信息。 目前已支持通过 Payments App 操作，API 即将开放。 | 2025-12-03 | | **转出目的地** | 新增[转出目的地](/payments/cn/guides/destinations)功能，用于集中管理资金转出时的目的地信息。 目前已支持通过 Payments App 操作，API 即将开放。 | 2025-12-03 | ## 2025 年 11 月 | 功能 | 变更说明 | 发布时间 | | ------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | | **资金管理** | (SDK v1.27.0) Get payer balance 操作已删除。 | 2025-11-26 | | **汇率** | (SDK v1.27.0) 新增 [Batch get exchange rates](/payments/en/api-references/payment/batch-get-exchange-rates) 操作，用于批量获取汇率。 | 2025-11-26 | | **SDK & API** | (SDK v1.27.0) [Get Access Token](/v2/api-references/oauth/get-access-token) 和 [Refresh Access Token](/v2/api-references/oauth/refresh-access-token) 操作已废弃。 | 2025-11-26 | | **退款** | (SDK v1.26.0) 新增 [Create refund link](/payments/en/api-references/payment/create-refund-link) 操作，用于创建退款链接。`RefundStatus` Schema 新增 `AddressPending` 和 `AddressSubmitted` 状态。 | 2025-11-12 | ## 2025 年 10 月 | 功能 | 变更说明 | 发布时间 | | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | | **资金管理** | (SDK v1.25.0) [Create settlement request](/payments/en/api-references/payment/create-settlement-request) 操作中，先前已废弃的 `settlements.currency` 和 `settlements.bank_account_id` 字段现已删除。请使用顶层的 `currency` 和 `bank_account_id` 字段来指定法币币种和银行账户。 | 2025-10-30 | | **支付链接** | (SDK v1.25.0) 新增 [Create order link](/payments/en/api-references/payment/create-order-link) 操作，用于创建收款订单的支付链接。 | 2025-10-30 | | **收款** | (SDK v1.25.0) - 新增 `payment.transaction.failed` 事件。该事件会在充币交易合规筛查不通过时触发。
- [Create pay-in order](/payments/en/api-references/payment/create-pay-in-order) 请求体新增 `amount_tolerance` 字段，用于指定可接受的少付金额偏差。 | 2025-10-30 | | **商户管理** | 新增自动创建钱包功能，简化商户配置流程，提升接入效率。详情请参考[创建商户](/payments/cn/guides/preparation#创建商户)。相关 API 操作：[Create merchant](/payments/en/api-references/payment/create-merchant)、[List all merchants](/payments/en/api-references/payment/list-all-merchants)。 | 2025-10-21 | | **商户管理** | (SDK v1.24.0) [Create merchant](/payments/en/api-references/payment/create-merchant) 以及 [List all merchants](/payments/en/api-references/payment/list-all-merchants) 操作新增 `wallet_setup` 字段，用于指定商户的钱包配置。同时废弃了 `wallet_id` 字段。 | 2025-10-15 | | **资金管理** | (SDK v1.24.0) - [Estimate fees](/payments/en/api-references/payment/estimate-fees) 操作：用于预估各类操作的手续费。
- [Create settlement request](/payments/en/api-references/payment/create-settlement-request) 请求包体新增 `currency`、`bank_account_id`、`remark` 字段。
- `SettleRequestStatus` Schema 新增 `Canceled` 状态：表示银行转账失败。
- `Settlement` Schema 新增 `currency`、`received_amount_fiat` 和 `bank_account` 字段。 | 2025-10-15 | | **收款** | (SDK v1.24.0) - [Create pay-in order](/payments/en/api-references/payment/create-pay-in-order) 操作新增 `custom_exchange_rate` 字段：支持自定义汇率。
- `merchant_id` 字段在 [Create/Get top-up address](/payments/en/api-references/payment/createget-top-up-address)、[Update top-up address](/payments/en/api-references/payment/update-top-up-address)、[List payers](/payments/en/api-references/payment/list-payers) 操作中变更为可选。 | 2025-10-15 | | **资金管理** | 为了简化结算流程，提升用户体验，我们对 Payments API 进行了优化，取消了可结算余额、强制归集等概念和相关操作：

**废弃的操作：**
- 可结算余额查询：[Get withdrawable balances](/payments/en/api-references/payment/get-withdrawable-balances)
- 支付钱包余额查询：[List payment wallet balances](/payments/en/api-references/payment/list-payment-wallet-balances)
- 强制归集操作：[Create forced sweep](/payments/en/api-references/payment/create-forced-sweep)、[List forced sweeps](/payments/en/api-references/payment/list-forced-sweeps)

**废弃的字段：**
- [List merchant balances](/payments/en/api-references/payment/list-merchant-balances) 和 [Get developer balance](/payments/en/api-references/payment/get-developer-balance) 中的 `available_balance` 字段
- [Create pay-in order](/payments/en/api-references/payment/create-pay-in-order) 中的 `use_dedicated_address` 字段

上述操作及字段仅为兼容旧版本而保留，不建议在新实现中继续使用。 | 2025-10-01 | ## 2025 年 09 月 | 功能 | 变更说明 | 发布时间 | | -------- | ----------------------------------------------------------------------------------- | ---------- | | **支持的链** | 新增支持 Solana 链。 | 2025-09-26 | | **收款** | 订单模式新增支持 [payment.transaction.completed](/payments/cn/guides/status-and-events) 事件。 | 2025-09-05 | ## 2025 年 08 月 | 功能 | 变更说明 | 发布时间 | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- | | **资金管理** | (SDK v1.22.0) - [Create settlement request](/payments/en/api-references/payment/create-settlement-request) 请求包体中的 `settlements.token_id` 字段从可选改为必填。同时，`settlements.amount` 字段仅表示待结算的加密货币金额，不再表示法币金额。
- 新增余额相关操作：[List merchant balances](/payments/en/api-references/payment/list-merchant-balances)、[Get developer balance](/payments/en/api-references/payment/get-developer-balance)、[List payment wallet balances](/payments/en/api-references/payment/list-payment-wallet-balances)、[Get payer balance](/payments/en/api-references/payment/get-payer-balance) | 2025-08-28 | | **资金管理** | (SDK v1.21.0) 新增结算相关操作：[List all settlement details](/payments/en/api-references/payment/list-all-settlement-details)、[Create crypto address](/payments/en/api-references/payment/create-crypto-address)、[Delete crypto address](/payments/en/api-references/payment/delete-crypto-address)。 | 2025-08-13 | | **退款** | (SDK v1.21.0) 新增退款相关操作：[Update refund order](/payments/en/api-references/payment/update-refund-order)、[Cancel refund order](/payments/en/api-references/payment/cancel-refund-order)。 | 2025-08-13 | | **支付链接** | - 新增支持通过第三方钱包进行支付，支持 EVM 和 Tron 链主流钱包。
- 新增支持通过 `cryptoAmount` 参数直接以加密货币指定订单金额。 | 2025-08-11 | ## 2025 年 07 月 | 功能 | 变更说明 | 发布时间 | | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | | **收款** | (SDK v1.20.0) - [Create pay-in order](/payments/en/api-references/payment/create-pay-in-order) 新增功能：支持直接以加密货币指定订单金额。当 `currency` 参数为空时，`order_amount` 和 `fee_amount` 将以 `token_id` 指定的加密货币为单位，而不是法币。
- 新增 [Update top-up address](/payments/en/api-references/payment/update-top-up-address) 操作，用于更新充值地址。
- 新增 `payment.address.updated` Webhook 事件，用于通知充值地址更新。 | 2025-07-30 | | **资金管理** | (SDK v1.20.0) - 新增强制归集相关操作：[Create forced sweep](/payments/en/api-references/payment/create-forced-sweep)、[List forced sweeps](/payments/en/api-references/payment/list-forced-sweeps)。
- [Get withdrawable balances](/payments/en/api-references/payment/get-withdrawable-balances) 新增 `available_balance` 和 `total_balance` 字段，分别代表可结算余额和总余额。 | 2025-07-30 | | **支付链接** | 新增支持通过 `developerName` 参数自定义收单页面底部的 "Powered by xxx" 字样。 | 2025-07-30 | | **资金管理** | [Create settlement request](/payments/en/api-references/payment/create-settlement-request) 新增功能：当 `order_ids` 参数为空时，自动结算该商户的所有未结算订单。 | 2025-07-24 | | **收款** | 新增支持充值模式，您可在 Web 界面：创建和管理充值地址、监控充值交易状态、导出充值记录。 | 2025-07-10 | | **收款** | (SDK v1.18.0) 新增充值模式相关操作：[Create/Get top-up address](/payments/en/api-references/payment/createget-top-up-address)、[List payers](/payments/en/api-references/payment/list-payers)。具体集成步骤请参考[获取充值地址](/payments/cn/guides/get-topup-addresses)。新增与充值模式相关的多个 [Webhook 事件](/payments/cn/guides/status-and-events)。 | 2025-07-02 | ## 2025 年 06 月 | 功能 | 变更说明 | 发布时间 | | ---------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ---------- | | **报表与仪表盘** | 新增仪表盘、余额查询、报表导出功能。 | 2025-06-27 | | **商户管理** | 新增支持全托管钱包。 | 2025-06-19 | | **资金管理** | (SDK v1.17.0) 新增支持加密货币提现的结算方式。相关操作：[Create settlement request](/payments/en/api-references/payment/create-settlement-request)、[List crypto addresses](/payments/en/api-references/payment/list-crypto-addresses)。 | 2025-06-18 | | **退款** | (SDK v1.17.0) [Create refund order](/payments/en/api-references/payment/create-refund-order) 新增开发者费用相关字段。您可以在退款时向商家收取开发者费用。更多信息可参考[处理退款申请](/payments/cn/guides/handle-abnormality-order#处理退款申请)。 | 2025-06-18 | | **支付链接** | (SDK v1.17.0) 新增以下操作，用于完成 Checkout SDK 的 OAuth 认证：[Get Access Token](/v2/api-references/oauth/get-access-token)、[Refresh Access Token](/v2/api-references/oauth/refresh-access-token)。 | 2025-06-18 | | **资金管理** | 新增支持加密货币出金的结算方式。 | 2025-06-10 | | **支付链接** | (Checkout SDK v1.1.0) Checkout SDK 提供开箱即用的收单前端组件，支持 iframe 嵌入方式快速集成。 | 2025-06-09 |