> ## Documentation Index
> Fetch the complete documentation index at: https://docs.y.uno/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Test in the sandbox first: base URL https://api-sandbox.y.uno (Test Mode in the Dashboard). Production is https://api.y.uno (Live Mode).
> Every API request needs the public-api-key and private-secret-key headers. Get them in the Dashboard at https://dashboard.y.uno/developers (Developers > Credentials); sandbox and production keys are different.
> Send an X-Idempotency-Key (a UUID) when creating payments, refunds and cancels, so retries do not create duplicates.
> Start with the Quickstart (https://docs.y.uno/docs/quickstart.md) and the agent guide (https://docs.y.uno/agents.md). To search these docs from a coding agent, connect the docs MCP server at https://docs.y.uno/mcp.

# Cuentas

> Crea, edita y revisa las cuentas de tu organización, y asígnalas a grupos

Una **cuenta** es una unidad dentro de tu organización que puede representar un país, una franquicia o una unidad de negocio, con sus propios usuarios, conexiones y claves. La pestaña **Accounts** es donde las creas, editas y revisas.

Ábrela desde **Organization → Accounts**.

<video src="https://github.com/writechoiceorg/yuno-images/raw/main/doc/yourPaymentsOperationSystem/accounts2.mp4" loop autoPlay muted playsInline />

## Por qué las organizaciones usan varias cuentas

* **Gestión de acceso granular**: cada cuenta puede representar un país, una franquicia, una unidad de negocio o cualquier segmentación que necesites, de modo que el acceso y los datos se mantienen separados.
* **Roles de usuario diversos**: una persona puede trabajar en varias cuentas con un rol distinto en cada una. Consulta [Roles](https://docs.y.uno/es/docs/using-yuno/organization/roles.md).
* **Reportes más claros**: las secciones que comparan cuentas te permiten combinar exactamente las que quieras, sin tener que manejar inicios de sesión separados.

## Los clientes y los métodos de pago son de alcance organizacional

Las cuentas separan el acceso, las conexiones y las claves. No separan los registros de clientes ni de métodos de pago. Un cliente creado en una cuenta, y cualquier método de pago almacenado en el vault que se haya inscrito para él, pertenece a toda la organización: cualquier otra cuenta de la misma organización puede recuperarlo o reutilizarlo. El `merchant_customer_id` que eliges al [crear un cliente](https://docs.y.uno/reference/customers/create-customer.md) debe ser único en toda la organización, no solo dentro de una cuenta: reutilizar un id que otra cuenta ya usó devuelve `CUSTOMER_ID_DUPLICATED`.

> [!NOTE]
>
> **Operar varias empresas en una misma organización**
>
> Si cada unidad de negocio necesita sus propios registros de clientes, separados lógicamente, asigna a `merchant_customer_id` un prefijo específico de la empresa (por ejemplo `cvc-mx-12345`) al crear clientes desde la cuenta de esa unidad de negocio. Yuno no aísla por sí solo los clientes ni los tokens almacenados en el vault por cuenta, así que la separación tiene que venir de cómo construyas el id. Confirma que este enfoque cubre tus necesidades antes de depender de él.
>
> Si en cambio necesitas una segregación total, sin clientes ni tokens compartidos, usa una organización de Yuno distinta por unidad de negocio en lugar de cuentas separadas en la misma organización.

Esto coincide con cómo las referencias de [PCI Proxy](https://docs.y.uno/es/docs/security-and-compliance/pci-proxy/forward-proxy.md) y [Enroll Payment Method](https://docs.y.uno/reference/payment-methods-direct-workflow/enroll-payment-method-api.md) describen `yuno-account-id` y `organization_customer_external_id`: los tokens almacenados en el vault y el id externo de cliente del comercio siempre tienen alcance organizacional.

## Asignar cuentas a grupos

Selecciona una o más cuentas y usa **Add to group** para ubicarlas en un [grupo de cuentas](https://docs.y.uno/es/docs/using-yuno/organization/account-groups.md). Una cuenta pertenece a un grupo a la vez, por lo que agregarla a un grupo nuevo la quita del anterior, y el cuadro de diálogo lo indica antes de que confirmes.

Este es el único lugar donde una cuenta **se mueve** entre grupos. La acción **Add accounts** dentro de la página de detalles de un grupo solo ofrece cuentas sin grupo.

## Definir una cuenta preferida

Puedes marcar una cuenta como preferida. Se convierte en la selección por defecto en el [chip de contexto](https://docs.y.uno/es/docs/using-yuno/account-context.md), de modo que el dashboard se abre en la cuenta que más te importa.

## Encontrar los IDs de cuenta

Cada cuenta tiene Account IDs únicos para Live Mode y Test Mode. Abre la cuenta desde esta pestaña para verlos, o búscalos en la sección [Developers](https://docs.y.uno/es/docs/using-yuno/settings/developers-credentials.md).

## Documentación relacionada

* [Grupos de cuentas](https://docs.y.uno/es/docs/using-yuno/organization/account-groups.md): agrupar cuentas para dar acceso a gran escala.
* [Account context](https://docs.y.uno/es/docs/using-yuno/account-context.md): elegir qué cuentas te muestra el dashboard.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.