通用测试

本指南提供了针对 Cobre 集成的通用测试方法，并按 Payin 和 Payout 分类列出了推荐的测试用例。本指南旨在帮助您验证 正常路径 和 常见故障场景，并确保您的集成在各环境中均能正常运行。

QA / 沙盒环境

Cobre 的测试环境目前基于 QA 环境。如需在 QA 中使用 API，请联系您的客户经理申请 QA 凭证（client_id 和 client_secret）。

基础域名（QA）： https://api.qa.cobre.co

下表列出了已提供 QA 环境的产品/解决方案及部分附加接口端点：

对于上方标记为 false 的产品，Cobre 会部署一个专用的上线前测试实例，而不是 QA，用于支持该产品的开发、测试和用户验收测试（UA）。

上线前测试实例与您最终的正式生产环境完全隔离：拥有独立的凭证（client_id/client_secret）、独立的 Portal 用户，以及独立的数据。它既不是 QA，也不是您的正式生产实例。

凭证与数据隔离 —— 拥有自己的凭证、Portal 用户和数据，与 QA 及最终的正式生产实例均相互隔离。

保密性与 SLA —— 上线前测试实例中的数据遵循与您生产环境相同的保密性和数据脱敏标准，以及相同的支持 SLA。

上线过渡 —— 一旦您准备好正式上线运营，Cobre 会部署一个额外的、独立的正式实例，拥有其自身独立的凭证、Portal 用户和数据。上线前测试实例不会被提升或合并到该正式实例中。

停用 —— 上线前测试实例可根据您的请求进行停用（decommission）。

上线前测试实例运行在生产级基础设施之上，但它是与您的正式生产实例分离的独立账户——凭证独立，数据独立。请勿将其中一方的活动视为另一方的反映。

Colombia

通用 API

Payin 解决方案

描述	接口端点	QA	备注
直连资金流动	`/v1/money_movements`	`true`	支持 PSE 和 Bancolombia 通道的完整测试方案
Checkout	`/v1/checkout`	`true`	可创建 Checkout，仅支持 Bancolombia 通道的完整测试方案

Nequi 和 Bre-B 暂不可用。

Payout 解决方案

描述	接口端点	在 QA 中可用	备注
资金流动	`/v1/money_movements`	`true`	完整测试方案
更改 PayOut 状态	`/v1/change_mm_state`	`true`	模拟状态流转至 `completed` 或 `rejected`

交易对手方的金融机构代码必须使用 1007，这是唯一可用的选项。

解决方案	验证项
认证	令牌生成、过期处理、刷新策略
资源创建	创建业务流程所需的账户和交易对手方
资金流动准确性	允许的 `source_id` / `destination_id` 组合、以最小货币单位表示的金额、幂等性行为、错误处理与重试
可观测性	Webhook 消费，以及通过资金流动查询和报告（如适用）进行对账

提示：请始终测试 正常路径 和 异常路径，并使用错误字典解析失败原因。