2026 年 07 月
| 功能 | 变更说明 | 发布时间 |
|---|---|---|
| 资金管理 | (SDK v1.39.0) Bulk Send：PaymentBulkSendItemValidationStatus 枚举新增 NotExecuted 取值。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。在 payment.address.updated Webhook 负载中新增 merchant_id 字段。 | 2026-06-25 |
| 资金管理 | (SDK v1.39.0) 划转（Allocation）状态追踪： ・List all batch allocations 和 Create batch allocation：响应新增 status 字段（Pending、Processing、Completed、PartiallyCompleted、Failed）。・Get batch allocation information：响应新增 status 字段。・List all allocation items：响应条目新增 status 字段（Pending、Transferring、Completed、Failed）。 | 2026-06-24 |
| 资金管理 | (SDK v1.37.0) 新增 List balance changes 操作，用于查询指定来源账户的余额变动记录。 Bulk Send 功能增强： ・List bulk send items：响应中新增 tx_hash 字段，返回每条批量下发记录对应的链上交易哈希。・List all bulk sends、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：新增可选字段 request_id，用于幂等控制，防止重复提交。响应中同步返回 request_id。・新增 List all bulk sends 操作，支持查询批量下发记录，可按 request_id 过滤。 | 2026-05-26 |
| 资金管理（不兼容变更） | (SDK v1.35.0) 以下已废弃的银行账户 API 操作已被永久移除，请改用转出目的地相关操作： - 查询银行账户列表（ GET /payments/bank_accounts）- 更新银行账户（ PUT /payments/bank_accounts/{bank_account_id}） | 2026-05-12 |
| 收款 | (SDK v1.35.0) 充值模式付款方功能增强： ・List payers 响应新增 custom_payer_id 字段，即商户侧的用户唯一标识。・新增 List payer transactions 操作，支持分页查询指定付款方的链上充值交易记录，可按 custom_payer_id、merchant_id、token_id、transaction_hash 等过滤。List payers 响应中的 transactions 字段已废弃，将在未来版本中移除。当前版本起，该字段最多返回最近 200 条交易，不再返回全部记录。 | 2026-05-12 |
2026 年 04 月
| 功能 | 变更说明 | 发布时间 |
|---|---|---|
| 资金管理 | (SDK v1.34.0) OffRamp 转出新增虚拟账户（VA）路由支持： ・Estimate fees：请求体新增 transfer_via_va 字段。设置为 true 表示通过虚拟账户转出至银行账户，false 表示直接转入银行账户。・ RecipientInfo Schema：转出响应中新增 transfer_via_va 字段，标识该笔转出是否通过虚拟账户路由。 | 2026-04-07 |
| 退款 | (SDK v1.34.0) Create refund link 新增可选字段 order_id。您现在可以通过 order_id 或 transaction_id 指定要退款的订单；此前仅支持 transaction_id。 | 2026-04-07 |
2026 年 03 月
| 功能 | 变更说明 | 发布时间 |
|---|---|---|
| 支付链接 | (SDK v1.33.0) 新增 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 助手是嵌入在 Cobo Portal 中的智能对话助手，可帮助您完成初始配置、方案设计、回答问题与排查。 | 2026-02-05 |
| 资金管理 | App 端新增支持批量下发功能。 | 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。 | 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 | 2026-02-05 |
2026 年 01 月
| 功能 | 变更说明 | 发布时间 |
|---|---|---|
| 收款 (不兼容变更) | (SDK v1.30.0) 调用 Create pay-in order 创建支付订单时，payable_currency 现在为必填参数。未传入上述字段将导致请求校验失败，无法创建支付订单。请更新你的请求体，确保请求中包含以上字段。 | 2026-01-22 |
| 支付链接 (不兼容变更) | (SDK v1.30.0) 调用 Create order link 创建支付链接时，pricing_currency、pricing_amount、payable_currencies 现在为必填参数。未传入上述字段将导致请求校验失败，无法创建支付链接。请更新你的请求体，确保请求中包含以上字段。 | 2026-01-22 |
| 资金管理 | (SDK v1.30.0) 全新资金转出（Payout）API 操作，转出流程更加高效，无需区分资金来源（收款/充值模式）或指定订单，只需填写金额即可完成转出。进行加密货币转账时，支持自动跨链，可将分布在不同链上的同一代币一次性转出至一个目标地址。 涉及的 API 操作包括： - Create payout - List all payouts - Get payout information 以下资金转出操作已废弃： - Create settlement request - List all settlement requests - Get settlement request information - List all settlement details 上述操作目前仍可继续使用，但建议尽快迁移至新的 API 操作，以获得更好的资金转出体验。 | 2026-01-22 |
| 资金管理 | (SDK v1.30.0) 新增批量下发（Bulk Send）API 操作，支持加密货币批量转账功能： - Create bulk send - Get bulk send information - List bulk send items | 2026-01-22 |
| 收款 | (SDK v1.30.0) 新增 Batch Create Top-up Address 操作，支持批量获取充值地址。 | 2026-01-22 |
| 资金管理 | (SDK v1.30.0) Estimate fees 操作的 fee_type 枚举新增支持以下取值，用于预估各类资金转出方式的手续费： - CryptoPayout（加密货币转账） - CryptoPayoutBridge（加密货币转账，包含跨链操作） - OffRampPayout（Off-ramp 对接） 同时废弃了 CryptoSettlement 和 OffRampSettlement 取值。 | 2026-01-22 |
| 资金管理 | （SDK v1.30.0） 为提升参数命名一致性与结果可读性，以下划转资金（Allocation）操作中的字段名称已更新，请您同步调整请求参数与返回结果的解析逻辑： - Create batch allocation 操作中的 allocation_requests 字段更新为 allocation_params。 - Get batch allocation information 中的返回字段 allocation_records 已更名为 allocation_items。 - List all allocation records 操作更名为 List all allocation items，返回中的字段 allocation_record_id 更名为 allocation_item_id。 请您尽快完成字段名称更新，以确保资金划转相关功能在后续版本中的兼容性。 | 2026-01-22 |
| 转出目的地 | (SDK v1.30.0) 以下操作已废弃，请使用转出目的地（Destination）相关操作。 -List all bank accounts -Create crypto address -Delete crypto address -List crypto addresses | 2026-01-22 |
2025 年 12 月
| 功能 | 变更说明 | 发布时间 |
|---|---|---|
| 交易对手方 | (SDK v1.29.0) 新增交易对手方 API 操作，用于管理付款方信息： - Create counterparty - List all counterparties - Get counterparty information - Update counterparty - Delete counterparty - Create counterparty entry - List counterparty entries - Get counterparty entry information - Delete counterparty entry | 2025-12-29 |
| 转出目的地 | (SDK v1.29.0) 新增转出目的地 API 操作，用于集中管理资金转出时的目的地信息： - Create destination - List all destinations - Get destination information - Update destination - Delete destination - Create destination entry - List destination entries - Get destination entry information - Update destination entry - Delete destination entry | 2025-12-29 |
| 报表 | (SDK v1.29.0) 新增报表 API 操作，用于生成和管理报表： - Generate reports - List all reports | 2025-12-29 |
| 资金管理 | (SDK v1.29.0) List all bank accounts 操作已废弃。 | 2025-12-29 |
| 资金管理 | (SDK v1.28.0) 新增划转 API 操作，用于在不同账户之间灵活分配资金： - Get available allocation amount - Create batch allocation - Get batch allocation information - List all batch allocations - List all allocation records | 2025-12-18 |
| 收款 | (SDK v1.28.0) Create pay-in order 和 Create order link 字段简化：支持自定义应付金额，去除 exchange_rate 字段，并优化了部分字段命名，增强了可读性和易用性。金额字段的全局精度统一为 2 位小数，方便对账和资金管理。Create pay-in order： - 新增字段： pricing_currency、pricing_amount、payable_currency、payable_amount。- 已废弃字段： currency、order_amount、token_id、custom_exchange_rate。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 创建订单支付链接时，新增 return_url 字段，现支持配置商户原购物页 URL。在用户支付成功或遇到异常时，可跳转回原购物页面，提升用户支付体验。 | 2025-12-18 |
| 资金管理 | - 新增划转功能，支持在不同账户之间手动分配资金。目前已支持通过 Payments App 操作，API 即将开放。 - 新增账户概念。账户为系统账本下管理的虚拟资金主体。详见账户与资金分配。 - 简化了资金转出流程。转出时无需选择资金来源（收款或充值模式）或指定订单，只需直接填写金额，更加高效便捷。目前已支持通过 Payments App 操作，API 即将开放。详见Off-Ramp 对接和加密货币转账。 | 2025-12-12 |
| 支付链接 | 订单支付链接全新改版： - 全新视觉与交互设计 - 桌面端新增支持 Binance Wallet（EVM 及 Solana 链） - 支持扫描含金额的二维码，自动填充转账金额 - 第三方钱包调用优化：调用流程简化、支持推荐前一次使用的钱包 | 2025-12-12 |
| 交易对手方 | 新增交易对手方功能，用于管理付款方信息。 目前已支持通过 Payments App 操作，API 即将开放。 | 2025-12-03 |
| 转出目的地 | 新增转出目的地功能，用于集中管理资金转出时的目的地信息。 目前已支持通过 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 操作，用于批量获取汇率。 | 2025-11-26 |
| SDK & API | (SDK v1.27.0) Get Access Token 和 Refresh Access Token 操作已废弃。 | 2025-11-26 |
| 退款 | (SDK v1.26.0) 新增 Create refund link 操作，用于创建退款链接。RefundStatus Schema 新增 AddressPending 和 AddressSubmitted 状态。 | 2025-11-12 |
2025 年 10 月
| 功能 | 变更说明 | 发布时间 |
|---|---|---|
| 资金管理 | (SDK v1.25.0) Create settlement request 操作中，先前已废弃的 settlements.currency 和 settlements.bank_account_id 字段现已删除。请使用顶层的 currency 和 bank_account_id 字段来指定法币币种和银行账户。 | 2025-10-30 |
| 支付链接 | (SDK v1.25.0) 新增 Create order link 操作，用于创建收款订单的支付链接。 | 2025-10-30 |
| 收款 | (SDK v1.25.0) - 新增 payment.transaction.failed 事件。该事件会在充币交易合规筛查不通过时触发。- Create pay-in order 请求体新增 amount_tolerance 字段，用于指定可接受的少付金额偏差。 | 2025-10-30 |
| 商户管理 | 新增自动创建钱包功能，简化商户配置流程，提升接入效率。详情请参考创建商户。相关 API 操作：Create merchant、List all merchants。 | 2025-10-21 |
| 商户管理 | (SDK v1.24.0) Create merchant 以及 List all merchants 操作新增 wallet_setup 字段，用于指定商户的钱包配置。同时废弃了 wallet_id 字段。 | 2025-10-15 |
| 资金管理 | (SDK v1.24.0) - Estimate fees 操作：用于预估各类操作的手续费。 - 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 操作新增 custom_exchange_rate 字段：支持自定义汇率。- merchant_id 字段在 Create/Get top-up address、Update top-up address、List payers 操作中变更为可选。 | 2025-10-15 |
| 资金管理 | 为了简化结算流程，提升用户体验，我们对 Payments API 进行了优化，取消了可结算余额、强制归集等概念和相关操作： 废弃的操作： - 可结算余额查询：Get withdrawable balances - 支付钱包余额查询：List payment wallet balances - 强制归集操作：Create forced sweep、List forced sweeps 废弃的字段： - List merchant balances 和 Get developer balance 中的 available_balance 字段- Create pay-in order 中的 use_dedicated_address 字段 上述操作及字段仅为兼容旧版本而保留，不建议在新实现中继续使用。 | 2025-10-01 |
2025 年 09 月
| 功能 | 变更说明 | 发布时间 |
|---|---|---|
| 支持的链 | 新增支持 Solana 链。 | 2025-09-26 |
| 收款 | 订单模式新增支持 payment.transaction.completed 事件。 | 2025-09-05 |
2025 年 08 月
| 功能 | 变更说明 | 发布时间 |
|---|---|---|
| 资金管理 | (SDK v1.22.0) - Create settlement request 请求包体中的 settlements.token_id 字段从可选改为必填。同时，settlements.amount 字段仅表示待结算的加密货币金额，不再表示法币金额。- 新增余额相关操作：List merchant balances、Get developer balance、List payment wallet balances、Get payer balance | 2025-08-28 |
| 资金管理 | (SDK v1.21.0) 新增结算相关操作：List all settlement details、Create crypto address、Delete crypto address。 | 2025-08-13 |
| 退款 | (SDK v1.21.0) 新增退款相关操作：Update refund order、Cancel refund order。 | 2025-08-13 |
| 支付链接 | - 新增支持通过第三方钱包进行支付，支持 EVM 和 Tron 链主流钱包。 - 新增支持通过 cryptoAmount 参数直接以加密货币指定订单金额。 | 2025-08-11 |
2025 年 07 月
| 功能 | 变更说明 | 发布时间 |
|---|---|---|
| 收款 | (SDK v1.20.0) - Create pay-in order 新增功能：支持直接以加密货币指定订单金额。当 currency 参数为空时，order_amount 和 fee_amount 将以 token_id 指定的加密货币为单位，而不是法币。- 新增 Update top-up address 操作，用于更新充值地址。 - 新增 payment.address.updated Webhook 事件，用于通知充值地址更新。 | 2025-07-30 |
| 资金管理 | (SDK v1.20.0) - 新增强制归集相关操作：Create forced sweep、List forced sweeps。 - Get withdrawable balances 新增 available_balance 和 total_balance 字段，分别代表可结算余额和总余额。 | 2025-07-30 |
| 支付链接 | 新增支持通过 developerName 参数自定义收单页面底部的 “Powered by xxx” 字样。 | 2025-07-30 |
| 资金管理 | Create settlement request 新增功能：当 order_ids 参数为空时，自动结算该商户的所有未结算订单。 | 2025-07-24 |
| 收款 | 新增支持充值模式，您可在 Web 界面：创建和管理充值地址、监控充值交易状态、导出充值记录。 | 2025-07-10 |
| 收款 | (SDK v1.18.0) 新增充值模式相关操作：Create/Get top-up address、List payers。具体集成步骤请参考获取充值地址。新增与充值模式相关的多个 Webhook 事件。 | 2025-07-02 |
2025 年 06 月
| 功能 | 变更说明 | 发布时间 |
|---|---|---|
| 报表与仪表盘 | 新增仪表盘、余额查询、报表导出功能。 | 2025-06-27 |
| 商户管理 | 新增支持全托管钱包。 | 2025-06-19 |
| 资金管理 | (SDK v1.17.0) 新增支持加密货币提现的结算方式。相关操作：Create settlement request、List crypto addresses。 | 2025-06-18 |
| 退款 | (SDK v1.17.0) Create refund order 新增开发者费用相关字段。您可以在退款时向商家收取开发者费用。更多信息可参考处理退款申请。 | 2025-06-18 |
| 支付链接 | (SDK v1.17.0) 新增以下操作，用于完成 Checkout SDK 的 OAuth 认证：Get Access Token、Refresh Access Token。 | 2025-06-18 |
| 资金管理 | 新增支持加密货币出金的结算方式。 | 2025-06-10 |
| 支付链接 | (Checkout SDK v1.1.0) Checkout SDK 提供开箱即用的收单前端组件，支持 iframe 嵌入方式快速集成。 | 2025-06-09 |