创建或关联账户

此接口端点是在 Cobre 上注册任何账户的统一入口。其行为由请求体中的 action 字段驱动：

`action`	功能说明	服务商类型
`connect`	关联在受支持金融机构已有的现有账户。	银行服务商（例如 `pr_mex_072`、`pr_col_1007`）
`create`	在墨西哥、哥伦比亚或全球范围内开通新的 Cobre Balance 账户。	Cobre Balance 服务商（`pr_*_cobre`、`pr_global_cobre`）

您选择的 provider_id 决定了所需的 metadata 结构以及返回的响应对象。

连接状态生命周期

状态	含义	`action=create`	`action=connect`
`connecting`	Cobre 正在创建或关联该账户	是（初始状态）	是（初始状态）
`connected`	账户处于活跃且可操作状态	是	是
`disconnected`	与银行的实时连接已断开或取消关联	—	是
`failed`	开通或关联尝试失败	是	是
`closed`	账户已通过关闭 Cobre Balance关闭 — 仅适用于 `pr_mex_cobre3`	是（仅 `pr_mex_cobre3`）	—

何时使用 `action = create`

使用此流程开通 Cobre Balance——这是 Cobre 原生账户，可持有特定币种的资金，并支持实时支付、R2P、Bre-B 及跨境资金流转。

何时使用 `action = connect`

使用此流程关联您在合作银行已持有的账户。Cobre 将持续维持该连接，轮询日内余额，采集交易记录，并（在支持的情况下）允许您从该账户发起出款。

如需了解更多信息，请参阅以下详细指南

管理 Cobre Balances 指南

管理 Connect Accounts 指南

账户服务商

常见错误

将 action 与 provider_id 的用途混淆（connect 与 create）导致目标服务商不匹配。

发送的 metadata 结构与所在地区或服务商不匹配（例如墨西哥与哥伦比亚的 connect metadata 混用）。

假设所有服务商均支持相同的 account_type 及字段。

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

curl --location 'https://api.cobre.co/v1/accounts' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "provider_id": "pr_col_cobre", "action": "create", "tags": [ "This is a tag" ], "alias": "My first Cobre Balance Colombia" }'

{ "id": "acc_1212534tdfgs", "provider_id": "pr_mex_cobre3", "provider_name": "Cobre Balance Mexico 3", "connectivity": { "status": "connected", "description": "string" }, "alias": "My first Cobre account!", "metadata": { "available_services": [ "mm_push_from_account" ], "primary_account": "acc_2NDkMRjA1o" }, "account_number": "646180303700100016", "account_type": "clabe", "obtained_balance": 10000, "obtained_balance_at": "2024-07-05T11:21:34Z", "geo": "mex", "tags": [ "accounting" ], "currency": "mxn", "created_at": "2024-06-17T17:34:50Z", "updated_at": "2024-07-05T11:21:34Z" }

创建或关联账户

连接状态生命周期

何时使用 `action = create`

何时使用 `action = connect`

常见错误

Request

Responses

创建或关联账户

连接状态生命周期#

何时使用 action = create#

何时使用 action = connect#

常见错误#

Request

Responses

连接状态生命周期

何时使用 `action = create`

何时使用 `action = connect`

常见错误