本指南为 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 |
| Account Verification | false |
| Cobre Keys | false |
| Checkout (CO) | true |
| Cross Border | false |
| Notifications | true |
| Evidence | false |
可用性矩阵(总览)####
| 描述 | 接口端点 | QA | 备注 |
|---|
| 身份认证 | /v1/auth | true | 可在 QA 中生成 Token |
| 账户 | /v1/accounts | true | 可创建 Cobre Balance |
| Counterparties | /v1/counterparties | true | 可创建 Counterparty |
| 添加/移除资金 | /v1/account_test_transactions | true | 可向 Cobre Balance 添加或移除资金 |
| 描述 | 接口端点 | QA | 备注 |
|---|
| Direct Link 资金划转 | /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 |
不支持 Nequi 及钱包类型的 Counterparties。
通用测试原则#
每次集成需验证的内容#
| 解决方案 | 验证项 |
|---|
| 身份认证 | Token 生成、过期处理、刷新策略 |
| 资源创建 | 创建流程所需的账户和 Counterparties |
| 资金划转正确性 | 允许的 source_id / destination_id 组合、金额以最小货币单位表示、幂等性行为、错误处理与重试 |
| 可观测性 | Webhook 消费,以及通过资金划转查询和报表(如使用)进行对账 |
提示:请务必同时测试正常路径和异常路径,并使用错误码字典解读失败原因。
Modified at 2026-05-20 21:31:19