本指南提供了针对 Cobre 集成的通用测试方法,并按 Payin 和 Payout 分类列出了推荐的测试用例。本指南旨在帮助您验证 正常路径 和 常见故障场景,并确保您的集成在各环境中均能正常运行。QA / 沙盒环境#
Cobre 的测试环境目前基于 QA 环境。如需在 QA 中使用 API,请联系您的客户经理申请 QA 凭证(client_id 和 client_secret)。基础域名(QA): https://api.qa.cobre.co可用性#
下表列出了已提供 QA 环境的产品/解决方案及部分附加接口端点:| 国家 / 解决方案 | 在 QA 中可用 |
|---|
| 哥伦比亚 | true |
| 墨西哥 | false |
| Connect Account | false |
| 账户核验 | false |
| Cobre Keys | false |
| Checkout (CO) | true |
| Cross Border | false |
| 通知 | true |
| Evidence | false |
可用性矩阵(概览)####
| 描述 | 接口端点 | QA | 备注 |
|---|
| 认证 | /v1/auth | true | 可在 QA 中生成令牌 |
| 账户 | /v1/accounts | true | 可创建 Cobre Balance |
| Counterparties | /v1/counterparties | true | 可创建交易对手方 |
| 添加/移除资金 | /v1/account_test_transactions | true | 可向 Cobre Balance 添加或移除资金。 |
| 描述 | 接口端点 | QA | 备注 |
|---|
| 直连资金流动 | /v1/money_movements | true | 支持 PSE 和 Bancolombia 通道的完整测试方案 |
| Checkout | /v1/checkout | true | 可创建 Checkout,仅支持 Bancolombia 通道的完整测试方案 |
| 描述 | 接口端点 | 在 QA 中可用 | 备注 |
|---|
| 资金流动 | /v1/money_movements | true | 完整测试方案 |
| 更改 PayOut 状态 | /v1/change_mm_state | true | 模拟状态流转至 completed 或 rejected |
交易对手方的金融机构代码必须使用 1007,这是唯一可用的选项。
通用测试原则#
每次集成需验证的内容#
| 解决方案 | 验证项 |
|---|
| 认证 | 令牌生成、过期处理、刷新策略 |
| 资源创建 | 创建业务流程所需的账户和交易对手方 |
| 资金流动准确性 | 允许的 source_id / destination_id 组合、以最小货币单位表示的金额、幂等性行为、错误处理与重试 |
| 可观测性 | Webhook 消费,以及通过资金流动查询和报告(如适用)进行对账 |
提示:请始终测试 正常路径 和 异常路径,并使用错误字典解析失败原因。
Modified at 2026-06-12 23:18:07