1. Cobre Balances
🇨🇳 中文(简体)
  • 🇺🇸 English
  • 🇪🇸 Español
  • 🇨🇳 中文(简体)
  • Cobre 简介
    • 欢迎
    • 快速入门
    • 将 Cobre 文档接入 AI
    • 产品
      • 本地支付
        • 使用 Cobre 进行本地支付
        • 存款
          • 哥伦比亚
            • 退房
            • 请求支付
            • 通过 Nequi 进行直接扣款
            • 静态 Bre-B 键
            • 转入 (Transfer-In)
          • 墨西哥
            • 请求支付
            • 基于 CLABE 的虚拟余额账户
            • 虚拟 CLABEs
        • 支付
          • 哥伦比亚
            • 通过 Bre-B 进行资金划转
            • 通过 Cobre Fast Pay 进行资金划转
          • 墨西哥
            • 通过 CLABEs 和 SPEI 卡进行资金划转
          • Multi-region
            • 资金划转调度器
        • 其他功能
          • 批量资金划转
          • 启用审批工作流(双人复核)
      • 跨境支付
        • 使用 Cobre 进行跨境支付
      • 连接
        • 通过 Cobre 关联银行账户
      • 稳定币
        • 以稳定币进行全球 PayOuts
    • 其他功能
      • 账户核验
      • 通知与订阅
      • Cobre 安全保障
      • 性能与吞吐量
    • 使用 Cobre
      • 使用您生态系统中的支付工具进行 Bre-B PayOuts
      • 面向贷款机构的 Cobre
      • 通过 ERP 系统集成 Cobre
  • 网络门户
    • 简介与快速入门
    • 门户身份认证
    • 问题排查与支持
    • Movements
      • 审批流程(双人复核)
      • 本地资金划转
      • 单笔付款发起
      • 批量资金划转发起
      • 跨境资金划转
      • 支付链接
      • 调度程序
    • Transactions
      • 交易
    • Accounts
      • 账户与余额管理
      • 账户引用
        • 虚拟 CLABE
        • 转账账户(转入)
    • Counterparties
      • 交易对手
    • Reports
      • 报表与对账
    • Settings
      • 用户与角色管理
      • 安全与管控
    • Developers
      • 订阅管理
  • 开发者
    • API 指南
      • 快速入门
      • Authentication
      • Cobre Balances
        • 管理虚拟余额账户(Cobre Balances)
        • 账户关联
      • Connect Accounts
        • 管理 Connect Accounts
      • Counterparties
        • 管理 Counterparties
      • Local Payments
        • 资金流动
        • Payouts
          • Colombia
            • Fast Pay & ACH
            • Bre-B
          • Mexico
            • SPEI
          • Cross-Region
            • 批量资金流动审批
            • 资金流动调度器
            • 批量资金流动
          • Global
            • 稳定币全球收款
        • Payins
          • Colombia
            • Cobre Keys 与 Bre-B 集成
            • Checkout
            • Direct Link
            • Direct Debit
            • Transfer-In
          • Mexico
            • Direct Link
            • 账户参考——虚拟 CLABE
      • 跨境支付
        • 跨境支付
        • 创建 FX 报价
        • 创建跨境资金流动
        • 为您的全球 Cobre Balance 充值
      • 跨功能特性
        • 账户核验
        • 使用 Cobre Reports 在哥伦比亚进行对账
        • Reports
        • 报告调度器
        • Evidence API
        • 通知与订阅
        • FX 汇率提醒
      • 错误处理
        • 错误码字典
      • Testing
        • 通用测试说明
        • 测试用例
        • 测试 PSE 与 Bancolombia
      • Certification
        • 认证流程
        • Questionnaire
    • API Explorer
      • Authentication API
        • 身份验证
      • Cobre Balances
        • 创建或关联账户
          POST
        • 获取所有账户
          GET
        • 获取单个账户
          GET
        • 更新账户
          PATCH
        • 关闭 Cobre Balance
          DELETE
        • 获取单个账户交易记录
          GET
        • 查询单笔交易
          GET
        • 获取全部交易记录
          GET
        • 获取账户每日余额历史记录
          GET
        • Assign or Change Primary Account
          POST
        • Unlinking Primary Account
          DELETE
      • Account Verifications
        • 创建账户核验
        • 获取单条账户核验记录
        • 获取所有账户核验记录
      • Account References
        • 创建 Account Reference
        • 查询单条 Account Reference
        • 查询所有 Account References
        • 删除账户引用
        • 为您的账户引用生成证书
      • Cobre Keys
        • 创建 Key
        • 获取所有 Keys
        • 获取单个 Key
        • 注销 Key
        • 封禁或重新激活 Keys
      • Counterparties
        • 账户借记注册
          • 为 Direct Debit 注册 Counterparty
          • 获取所有注册记录
          • 获取单条注册记录
        • 创建 Counterparty
        • 获取单个 Counterparty
        • 获取所有 Counterparties
        • 删除 Counterparty
      • Money Movement Scheduler
        • 创建 Money Movement Scheduler
        • 列出所有 Money Movement Schedulers
        • 取消活跃的 Scheduler
      • Bulk Money Movement
        • 创建 Bulk Money Movement
        • 列出所有 Bulk Money Movements
        • 查询单条 Bulk Money Movement
      • Cross Border
        • 创建 FX 报价
        • 获取单条 FX 报价
        • 获取所有 FX 报价
        • 创建跨境资金划转
        • 获取单条跨境资金划转记录
        • 获取所有 Cross Border Money Movements
      • Checkout
        • 创建 Checkout
        • 获取单个 Checkout
        • 获取所有 Checkouts
        • 停用 Checkout
      • Evidence API
        • 证明材料请求
          • 获取证明材料请求
          • 搜索证明材料请求
        • 证明材料文件
          • 生成上传链接
          • 生成下载链接
        • 证明材料信息
          • 提交证明材料信息
      • Report Scheduler
        • 创建 Report Scheduler
        • 获取所有 Report Schedulers
        • 删除 Report Scheduler
      • Reports
        • 创建报告
        • 获取所有报告
        • 为所选报告生成下载链接
        • 创建 Cobre Balance 对账单
      • 资金流动
        • 创建资金流动
        • 查询单条资金流动记录
        • 查询所有资金流动记录
        • 查询单条 Money Movement
      • Bulk Money Movement 审批
        • Bulk Money Movements 审批决策
      • 资金流动审批
        • 审批资金流动
        • 列出所有资金流动审批
      • 通知与订阅
        • 订阅事件
        • 获取所有订阅
        • 删除订阅
        • 列出所有可用事件
      • Alerts
        • 创建告警
        • 获取所有告警
        • 获取单个告警
        • 停用告警
    • 平台目录
      • 哥伦比亚银行代码
      • 墨西哥银行代码
      • 账户服务商
      • 交易类型
      • 资金流动状态
    • 测试 API
      • 交易调整(QA)
      • 变更资金流动状态(QA)
    • 报告格式
      • 资金流动报告格式
        • 所有资金流动记录 (CSV)
        • 所有资金流动记录 (JSON)
        • SPEI 资金流动记录 (CSV)
        • LEGACY 资金流动记录 (CSV)
      • 交易记录布局
        • 所有交易记录 (CSV)
        • 所有交易记录 (JSON)
        • 虚拟余额账户 (Cobre Balance) 对账单 (PDF)
      • Counterparties 布局
        • 所有 Counterparties (CSV)
      • Multicash 布局
        • Multicash 标题行 (TXT)
        • Multicash 明细行 (TXT)
    • 通知布局
      • 账户事件
        • 账户余额借记
        • 账户余额贷记
      • Cobre Keys
        • Cobre Keys
      • Counterparties
        • Counterparties
      • 资金流动
        • 资金流动
      • 批量资金流动
        • 批量资金流动
      • 跨境资金划转
        • 跨境资金划转
      • Evidence Requests
        • Evidence Requests
      • Reports
        • Reports
      • Alerts
        • FX Alerts
      • 账户引用
        • 账户引用
  • Schemas
    • Counterparties
      • Colombia
        • PayOut
          • Counterparty | Create Metadata Type Cobre Balance (CO)
          • Counterparty | Response Metadata Type Cobre Balance (CO)
          • Counterparty | Create Metadata Type Breb Key (CO)
          • Counterparty | Response Metadata Type Breb Key (CO)
          • Counterparty | Create Metadata Type QR (CO)
          • Counterparty | Response Metadata Type QR (CO)
          • Counterparty | Create Metadata Type CC (CO)
          • Counterparty | Create Metadata Type CH (CO)
          • Counterparty | Create Metadata Type DP (CO)
          • Counterparty | Response Metadata Type CC (CO)
          • Counterparty | Response Metadata Type CH (CO)
          • Counterparty | Response Metadata Type DP (CO)
        • PayIn
          • Counterparty | Response Metadata Type r2p (CO)
          • Counterparty | Create Metadata Type r2p (CO)
          • Counterparty | Create Metadata Type r2p Breb (CO)
          • Counterparty | Response Metadata Type r2p Breb (CO)
        • Secondary Counterparty
          • Secondary Counterparty Create Request
          • Secondary Counterparty Create Response (CO)
          • Secondary Counterparty Create Metadata Type NP (CO)
          • Secondary Counterparty Request Metadata Type LE
          • Secondary Counterparty Response Metadata Type NP (CO)
          • Secondary Counterparty Response Metadata Type LE (CO)
        • Direct Debit
          • Direct Debit Registration | Response
          • Direct Debit Registration | List All Items
        • Counterparty | Create Request (CO)
        • Counterparty | Create Response (CO)
      • Mexico
        • PayOut
          • Counterparty | Create Metadata Type Clabe (MX)
          • Counterparty | Create Metadata Type SPEI Card (MX)
          • Counterparty | Response Metadata Type Clabe (MX)
          • Counterparty | Response Metadata Type SPEI Card (MX)
        • PayIn
          • Counterparty | Create Metadata Type r2p (MX)
          • Counterparty | Response Metadata Type r2p (MX)
        • Counterparty | Create Response (MX)
        • Counterparty | Create Request (MX)
        • Counterparty | Money Movement Return (MX)
      • Global
        • Counterparty | Global CP Request
        • Counterparty | Global Deposit NP request
        • Counterparty | Global Deposit NP response
        • Counterparty | Global Deposit LE request
        • Counterparty | Global Deposit LE response
        • Counterparty | Global CP Response
      • USA
        • Counterparty | Create Request (USA)
        • Counterparty | Create Response (USA)
        • Request Medatata Business
        • Response Medatata Business
        • Request Medatata Individual
        • Response Medatata Individual
      • Counterparty | List All Items
    • Transactions
      • Global
        • Transaction | Credit Cross Border
        • Transaction | Debit Cross Border
      • Colombia
        • Debit
          • Transaction | Debit FI (CO) (col_debit)
          • Transaction | Debit Cobre Balance (CO)
          • Transaction | Debit Breb (CO) (breb_debit)
        • Credit
          • Transaction | Credit Direct Debit (CO) (dd_credit)
          • Transaction | Rejected Breb (breb_rejected)
          • Transaction | Credit Top Up (CO) (col_top_up_credit)
          • Transaction | Credit FI (CO) (col_credit)
          • Transaction | Credit Cobre Balance (CO) (col_cb_credit)
          • Transaction | Credit r2p (r2p_credit)
          • Transaction | Credit Breb (CO) (breb_credit)
          • Transaction | Credit r2p Breb (CO) (r2p_breb_credit)
        • Transaction | Connect Obtain (CO)
        • Transaction | Cobre Balance Obtain (CO)
      • Mexico
        • Debit
          • Transaction | Debit SPEI (MX) (spei_debit)
          • Transaction | Debit FI (MX) (mex_debit)
          • Transaction | Debit Internal SPEI (MX)
        • Credit
          • Transaction | Credit SPEI (MX)
          • Transaction | Credit FI (MX)
          • Transaction | Credit Internal SPEI (MX)
        • Transaction | Connect Obtain (MX)
        • Transaction | Cobre Balance Obtain (MX)
        • Transaction | Return SPEI (MX)
      • Transactions | Cobre Balance List All Items
      • Transaction | Adjustment Credit
      • Transaction | Adjustment Debit
      • Transaction | Credit Misc
      • Transaction | Debit Misc
    • Authentication
      • Authentication | Request
      • Authentication | Response
    • Cobre Keys
      • Colombia
        • Cobre Key | Create Request
        • Cobre Key | Create Response
        • Cobre Key | Obtain Response
        • Cobre Key | Reactive Request
    • Money Movements
      • Approvals
        • Money Movement Approvals | Create Request
        • Money Movement Approvals | Create Response
        • Money Movement Approvals | List All Items
      • Mexico
        • PayOut
          • Money Movement | Create Metadata Type SPEI
          • Money Movement | Response Metadata Type SPEI
        • Return
          • Money Movement Return | Create Request
          • Money Movement Return | Create Response
          • Money Movement Return | Response Medatada Type SPEI
        • PayIn
          • Money Movement Direct Link | Create Metadata Rail r2p SPEI
          • Money Movement Direct Link | Response Metadata Rail r2p SPEI
      • Colombia
        • PayOut
          • Money Movement | Create Metadata Type Fast Pay
          • Money Movement | Create Metadata Type Bre-B
          • Money Movement | Create Metadata Type ACH
          • Money Movement | Response Metadata Type ACH
          • Money Movement | Response Metadata Type Fast Pay
          • Money Movement | Response Metadata Type Bre-B
          • Money Movement | Response Metadata Type Bre-B Split
        • PayIn
          • Money Movement Direct Link | Create Metadata Rail PSE
          • Money Movement Direct Link | Create Metadata Rail r2p Breb
          • Money Movement Direct Link | Response Metadata Rail r2p Breb
          • Money Movement Direct Link | Response Metadata Rail PSE
          • Money Movement Direct Link | Response Metadata Rail Bancolombia
          • Money Movement Direct Link | Response Metadata Rail Nequi
        • Direct Debit
          • Money Movement Direct Debit | Create Metadata
          • Money Movement Direct Debit | Response Metadata
      • Global
        • Payout in stable
          • Money Movement | Create Metadata Type Global (stable)
          • Money Movement | Response Metadata Type Global (stable)
      • Money Movement | List All Items
      • Money Movement | Create Response
    • Accounts
      • Account Verification
        • Mexico
          • Account Verification Create Metadata Type mex_acc_details_1
          • Account Verification Response Metadata Type mex_acc_details_1
          • Account Verification Create Metadata Type mex_acc_ownership_1
          • Account Verification Response Metadata Type mex_acc_ownership_1
        • Colombia
          • Account Verification Response Metadata Type col_key_details_1
          • Account Verification Create Metadata Type col_key_details_1
          • Account Verification Create Metadata Type col_key_ownership_1
          • Account Verification Response Metadata Type col_key_ownership_1
          • Account Verification Create Metadata Type col_key_ownership_2
        • Account Verification Create Response
        • Account Verifications List All Items
      • Account References
        • Account References Request
        • Account Reference Response
        • List all account references
        • Account Reference Certificate Generation Response
      • Daily Balance
        • Daily Balance Historiy List All Items
        • Daily Balance Obtain Response
      • Cobre Balances and Connect Accounts
        • Mexico
          • Cobre Balance | Create Response (MX)
          • Connect Account | Response Metadata (MX)
          • Connect Account | Create Metadata (MX)
          • Cobre Balance | Create Metadata (MX)
        • Colombia
          • Cobre Balance | Create Response (CO)
          • Connect Account | Response Metadata (CO)
          • Connect Account | Create Metadata (CO)
          • Cobre Balance | Create Metadata (CO)
        • Global
          • Cobre Balance | Create Response (Global)
          • Cobre Balance | Create Metadata (Global)
        • Cobre Balance | Create Request
        • Connect Account | Create Request
        • Accounts | List All Items
        • Account | Update Request
    • Bulk Money Movement
      • Bulk Money Movement | Obtain Response
      • Bulk Money Movement Decision | Create Request
      • Bulk Money Movements | List All Items
    • Money Movement Scheduler
      • Money Movement Scheduler | Create Request
      • Money Movement Scheduler | Create Response
      • Money Movement Scheduler | List All Items
    • Checkout
      • Colombia
        • Checkout | Create Request
        • Checkout | Create Response
        • Checkout | List All Items
        • Checkout | Delete
    • Notifications
      • Subscription | Create Request
      • Subscription | Create Response
      • Subscription | List All Items
      • Subscribable Events | List All Items
      • Subscribable Events | Metadata
    • Evidence Request
      • Schemas
        • Error
        • Evidence Request
        • Document Type
        • Evidence Id
        • Upload Intent
        • Evidence Request Id
        • Evidence Request Status
        • Information Type
        • Information
        • Evidence
        • Information Status
        • Document
        • Document Status
        • Headers
      • RequestBodies
        • Upload Intent Request
    • Cross Border
      • Cross Border Money Movement
        • Cross Border Money Movement Create Request
        • Cross Border Money Movement Obtain Response
        • Cross Border Money Movements List All Items
        • Cross Border Money Movement Create Response
      • FX Quote
        • FX Static Quote
          • FX Quote Rolling | Create Response
          • FX Quote Rolling | Cross Border Response
        • FX Rolling Quote
          • FX Quote Static | Create Response
          • FX Quote Static | Cross Border Response
        • FX Quote | Create Request
        • FX Quote | List All Items
        • FX Quote | Metadata Fees Breakdown
        • FX Quote | Metadata Quote Tiers
        • FX Quote | Metadata Penalization Tier
    • Reports
      • Download
        • Report Download Create Request
        • Report Download Create Response
      • Reports Create Request
      • Reports Create Response
      • Reports Create Metadata
      • Reports List All Items
      • Cobre Balance Statement Request
      • Cobre Balance Statement Response
    • Error Model
      • Error Model
    • Report Scheduler
      • Report Schedulers | Create Request
      • Report Schedulers | Delete Response
    • Alerts
      • Create Alert
      • Alert Object
      • List All Alerts
      • Alert | Metadata Type fx_rate
  1. Cobre Balances

更新账户

PATCH
https://api.cobre.co/v1/accounts/{acct_id}
该接口端点允许 Cobre 平台用户更新已有的 Cobre Balance(Virtual Balance、Virtual Balance Account)或 Connect Account。它支持修改我们生态系统中此前创建的账户信息,确保余额与账户管理的一致性和可控性。
如需了解更多信息,请参阅以下详细指南
Managing Cobre Balances guide
Managing Connect Accounts guide
Account Providers

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
OK
Bodyapplication/json

🟠409Conflicto
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PATCH 'https://api.cobre.co/v1/accounts/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "alias": "New alias",
    "tags": [
        "accounting"
    ]
}'
Response Response Example
200 - Cobre Balance - 哥伦比亚
{
    "id": "acc_BeIRr54sRq",
    "connectivity": {
        "status": "connected",
        "description": ""
    },
    "alias": "The new alias",
    "metadata": {
        "cobre_tag": "@cibaa01409",
        "available_services": [
            "account_balance",
            "mm_push_from_account",
            "account_transactions"
        ],
        "primary_account": ""
    },
    "currency": "cop",
    "geo": "col",
    "tags": [
        "treasury"
    ],
    "provider_id": "pr_col_cobre",
    "provider_name": "Cobre Balance Colombia",
    "account_number": "",
    "account_type": "cobre_balance",
    "obtained_balance": 36937102,
    "obtained_balance_at": "2025-11-25T14:07:45Z",
    "created_at": "2025-11-06T15:40:00Z",
    "updated_at": "2025-11-25T14:07:45Z"
}
Modified at 2026-05-20 21:31:19
Previous
获取单个账户
Next
关闭 Cobre Balance
Built with