Crear o Conectar una Cuenta

Este endpoint es el único punto de entrada para registrar cualquier cuenta en Cobre. Su comportamiento está determinado por el campo action en el cuerpo de la solicitud:

`action`	Qué hace	Familia de proveedores
`connect`	Vincula una cuenta existente en una institución financiera compatible.	Proveedores bancarios (p. ej. `pr_mex_072`, `pr_col_1007`)
`create`	Aprovisiona una nueva cuenta Cobre Balance en México, Colombia o a nivel global.	Proveedores de Cobre Balance (`pr_*_cobre`, `pr_global_cobre`)

El provider_id que elijas determina qué forma de metadata se requiere y qué objeto de respuesta recibirás.

Ciclo de Vida del Estado de Conectividad

Estado	Significado	`action=create`	`action=connect`
`connecting`	Cobre está aprovisionando o vinculando la cuenta	Sí (estado inicial)	Sí (estado inicial)
`connected`	La cuenta está activa y operativa	Sí	Sí
`disconnected`	Se perdió la conexión en vivo con el banco o se desvinculó	—	Sí
`failed`	El aprovisionamiento o el intento de conexión falló	Sí	Sí
`closed`	La cuenta fue cerrada mediante Cerrar un Cobre Balance — solo `pr_mex_cobre3`	Sí (solo `pr_mex_cobre3`)	—

Cuándo usar `action = create`

Usa este flujo para crear un Cobre Balance — una cuenta nativa de Cobre que mantiene fondos en una moneda determinada y habilita pagos en tiempo real, R2P, Bre-B y movimientos de dinero transfronterizos.

Cuándo usar `action = connect`

Usa este flujo para integrar una cuenta que ya tienes en un banco asociado. Cobre mantiene la conexión activa, consulta los saldos intradía, ingiere transacciones y (cuando es compatible) te permite enviar dinero desde esa cuenta.

Para más información consulta las guías detalladas a continuación

Guía de gestión de Cobre Balance

Guía de gestión de Cuentas Connect

Proveedores de cuenta

Errores Comunes

Mezclar la intención de action y provider_id (connect vs create) para el proveedor objetivo.

Enviar una forma de metadata que no corresponde a la geografía/proveedor (metadata de connect de México vs Colombia).

Asumir que todos los proveedores soportan el mismo account_type/campos.

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" }

Crear o Conectar una Cuenta

Ciclo de Vida del Estado de Conectividad

Cuándo usar `action = create`

Cuándo usar `action = connect`

Errores Comunes

Request

Responses

Crear o Conectar una Cuenta

Ciclo de Vida del Estado de Conectividad#

Cuándo usar action = create#

Cuándo usar action = connect#

Errores Comunes#

Request

Responses

Ciclo de Vida del Estado de Conectividad

Cuándo usar `action = create`

Cuándo usar `action = connect`

Errores Comunes