Cuentas de la empresa

GET/b2b/accounts

Devuelve las cuentas de tu empresa con su moneda, su saldo disponible y si es la cuenta principal. Endpoint de solo lectura del servicio business-api.

Esta guía explica cómo consultar las cuentas de tu empresa una vez que ya tienes un token de acceso válido. Si todavía no sabes cómo obtenerlo, empieza por Autenticación.

Para qué sirve

Es el punto de partida para el resto de las APIs disponibles. El walletId de cada cuenta es el identificador que necesitas en otros endpoints:

Dónde lo usas	Con qué nombre
`GET /b2b/movements/{accountId}` y `GET /b2b/movements/{accountId}/{movementId}`	`accountId`
Al crear un pago con `POST /b2b/transactions/payments`	`originAccountId`

En los dos casos el valor es el walletId que devuelve esta consulta.

URL base y autenticación

Ambiente	URL base
Producción	`https://api.global66.com/business-api`

El endpoint usa la misma credencial de API de tu empresa que ya usas para crear pagos. El token se obtiene con POST /b2b/auth (está explicado en Autenticación) y se envía en el header Authorization de cada request:

El endpoint no recibe parámetros: la empresa se identifica por el token.

Ejemplo de petición

Respuesta `200 OK`

La respuesta trae la lista accounts. Elige el caso que quieras ver:

Con cuentas
Sin cuentas

Una cuenta principal y una multicuenta con alias.

Si la empresa no tiene cuentas, la respuesta sigue siendo 200 con la lista vacía. No es un error.

Campos de cada cuenta

Los campos sin valor no se envían: no vienen como null. Tu integración debe tolerar que creationDate y alias falten.

walletId

integer

Identificador de la cuenta. Es el accountId de GET /b2b/movements/{accountId} y el originAccountId al crear un pago. Siempre viene. ej: 164926

currency

string

Moneda de la cuenta, en formato ISO 4217. Siempre viene. ej: USD

creationDate

string (date-time)

Fecha de creación de la cuenta, con formato yyyy-MM-ddTHH:mm:ss. Se omite si el core bancario no la informa, algo que pasa en algunas cuentas antiguas. ej: 2022-11-07T11:20:40

balance

number

Saldo disponible, en la moneda de la cuenta. Siempre viene. ej: 1500

alias

string

Nombre de la multicuenta. Se omite si la cuenta no tiene nombre. ej: Pagos proveedores

isPrincipal

boolean

Es true solo en la cuenta principal de la empresa. Siempre viene. ej: true

Comportamiento

Solo se devuelven las cuentas activas.
Se devuelven todas las cuentas de la empresa, una por moneda más las multicuentas.
Los campos sin valor no aparecen en la respuesta. No se envían como null.
Si la empresa no tiene cuentas activas, la respuesta es 200 con {"accounts": []}.

Errores

401

Unauthorized

Falta el header Authorization, o el token no es válido o venció. Pide uno nuevo con POST /b2b/auth. Lo responde el API Gateway, por eso el cuerpo es { "message": "Unauthorized" } y no el formato estándar de errores.

500

GENERIC_ERROR · 000500

Error interno al consultar las cuentas. Se puede reintentar.

Para saber qué errores reintentar y cuáles no, revisa Errores y reintentos.

Flujo típico

Obtén un token con POST /b2b/auth.
Consulta GET /b2b/accounts y elige la cuenta por currency, alias o isPrincipal.
Usa su walletId como accountId en GET /b2b/movements/{accountId}, o como originAccountId al crear un pago.

Siguientes pasos

Con el walletId en mano, usa la consulta de movimientos para listar los movimientos de la cuenta, y el detalle de movimientos para ver el detalle completo de cada uno.