Assign or Change Primary Account

POST

https://api.cobre.co/v1/accounts/{acct_id}/linkage_account

此接口端点允许为现有的 Cobre Balance（Virtual Balance 或 Virtual Balance Account）分配或更换主账户。

参见 Account Linkeage guide

常见错误

传入了错误地区或货币上下文的 acct_id。

关联了无效或已断开连接的主账户。

重新关联后忽略了下游影响（如自动路由规则的变更）。

Request

Authorization

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

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

Path Params

Body Params application/json

Examples

Responses

🟢200Correcto

application/json

Bodyapplication/json

🟠404No encontrado

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.cobre.co/v1/accounts//linkage_account' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "primary_account": "acc_134trew1w"
}'

Response Example

{
    "id": "acc_1212534tdfgs",
    "provider_id": "pr_col_cobre",
    "provider_name": "Cobre Balance Colombia",
    "connectivity": {
        "status": "creating",
        "description": "string"
    },
    "alias": "My first Cobre account!",
    "metadata": {
        "available_services": [
            "mm_push_from_account"
        ],
        "cobre_tag": "@citaa00015",
        "primary_account": "acc_134trew1w",
        "keys": [
            "key_qwertgf12345"
        ]
    },
    "account_number": "string",
    "account_type": "cobre_balance",
    "obtained_balance": 0,
    "obtained_balance_at": "2024-07-05T11:21:34Z",
    "geo": "col",
    "tags": [
        "accounting"
    ],
    "currency": "cop",
    "created_at": "2024-06-17T17:34:50Z",
    "updated_at": "2024-07-05T11:21:34Z"
}

Modified at 2026-05-20 21:31:19

获取账户每日余额历史记录

Unlinking Primary Account

Assign or Change Primary Account

常见错误#

Request

Responses

常见错误