Saltar al contenido principal
POST
Crear un grupo de cuentas
Crea un nuevo grupo (suborganización) dentro de tu organización. Los grupos de cuentas se pueden usar para organizar distintos comercios o unidades de negocio bajo una única entidad matriz. Pasa account_codes para asociar cuentas existentes al grupo en la misma solicitud. Un grupo nuevo siempre se crea como raíz; para anidarlo bajo otro grupo, define parent_code con Update Account Group.

Autorizaciones

PUBLIC-API-KEY
string
header
predeterminado:<Your PUBLIC-API-KEY>
requerido
PRIVATE-SECRET-KEY
string
header
predeterminado:<Your PRIVATE-SECRET-KEY>
requerido

Cuerpo

application/json
name
string
requerido

Nombre del grupo de cuentas (min=1, max=255).

merchant_id
string
requerido

Identificador único que el comercio usa en sus sistemas (min=1, max=255).

account_codes
string<uuid>[]

Opcional. Los id de las cuentas existentes que se asociarán al nuevo grupo en la misma transacción. Una cuenta pertenece a un solo grupo a la vez, por lo que una cuenta que ya está en otro grupo se mueve al nuevo. Si algún código no coincide con una cuenta activa de la organización, toda la solicitud falla y no se crea ningún grupo. El valor predeterminado es una lista vacía.

Respuesta

201 - application/json

Creado

id
string<uuid>

El identificador único del grupo de cuentas.

name
string
merchant_id
string
parent_code
string<uuid> | null

El id del grupo bajo el cual se anida este grupo. Siempre es null al crear: un grupo nuevo se crea como raíz y se anida después con Update Account Group.

created_at
string<date-time>
updated_at
string<date-time>