使用 Postman 探索 API

使用 Cobre 的官方 Postman Collections，端到端探索并测试 API — 从身份验证到通过本地与跨境轨道划转资金 — 无需先写任何代码。

这些 collection 位于公开的 Postman workspace。导入它们，填入凭证，几分钟内即可发送第一个请求。

🔗 在 Postman 中打开 Cobre API workspace

包含内容

一套 General (Getting Started) collection，涵盖所有产品共用的基础模块 — Authentication、Cobre Balance、Counterparties、Webhooks 和 Reports — 以及每个产品一套 collection：

Collection	覆盖范围
General (Getting Started)	Authentication、Cobre Balance、Counterparties、Webhooks、Reports。从这里开始。
PayIn — Colombia	在哥伦比亚收款（Nequi、PSE、R2P、Checkout、Direct Debit）。
PayIn — Mexico	在墨西哥收款（SPEI in、refunds）。
PayIn — Global	将国际付款收入到您的 Cobre balances。
PayOut — Colombia	在哥伦比亚付款（ACH / Fast Pay、Bre-B）。
PayOut — Mexico	在墨西哥付款（SPEI out）。
PayOut — Global	向国际 counterparties 付款。
Cross-Border (USD/COP)	FX 报价与跨境 money movements。

身份验证在各 collection 之间共享：您只需认证一次，后续每个请求都会复用该 token。

前置条件

要求	用途
带 API 凭证的 Cobre 账户（`client_id` 和 `secret`）	用于身份验证。如没有，请向您的 Key Account Manager 索取。
Postman（桌面应用或网页版）	用于导入并运行 collection。

1. 打开 workspace

打开 Postman 中的 Cobre API workspace，并将 collection fork 到您自己的 workspace。Fork 可让您的副本与 Cobre 的后续更新保持同步。

2. 配置 environment

workspace 自带一个 environment，其中包含请求所需的全部变量。

选择 Cobre environment（右上角选择器）。

填写：

CobreBaseURL

https://api.cobre.co → Production

https://api.qa.cobre.co → QA / Sandbox

client_id → 您的 client ID

secret → 您的 secret

将 access_token 留空 — 认证时会自动写入。

请将 client_id 和 secret 保存在您自己的私有 environment 中。切勿分享包含真实凭证的 environment。

3. 进行身份验证

打开 General → Authentication，点击 Send。

access token 会自动存入 access_token。

其他请求都会复用该 token — 无需按 collection 分别认证。

如果请求返回 401 Unauthorized，请重新运行 Authentication 后再试。

4. 发送第一个请求

推荐的第一条流程：

General → Cobre Balance → Create — 创建一个用于操作的 balance。

General → Counterparties → Create — 登记您将付款或收款的对象。

打开所需的产品 collection（例如 PayIn — Colombia），发送一笔 money movement。

需要了解

Idempotency。 创建资源的 POST 请求接受 idempotency header（最少 9 个字符）。每次操作发送唯一值，即可安全重试且不会产生重复。

Base URL。 所有请求都指向 {{CobreBaseURL}}，因此切换 environment 无需编辑请求。

Webhooks。 使用 General → Webhooks 订阅事件，并跟踪 money movements 的生命周期。

使用 Postman 探索 API

包含内容#

前置条件#

1. 打开 workspace#

2. 配置 environment#

3. 进行身份验证#

4. 发送第一个请求#

需要了解#

相关指南#

包含内容

前置条件

1. 打开 workspace

2. 配置 environment

3. 进行身份验证

4. 发送第一个请求

需要了解

相关指南