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

# Cuentas virtuales por cliente

> Identifica cada depósito por cliente final y concilia sin trabajo manual.

Plataformas que atienden a muchos clientes necesitan identificar **quién pagó cada depósito**. Con cuentas virtuales por cliente, cada abono llega referenciado a su dueño y se concilia solo.

## Flujo

```mermaid theme={null}
sequenceDiagram
  participant App as Tu plataforma
  participant Vita as Vita API
  participant Customer as Cliente final
  participant Bank as Banco

  App->>Vita: POST /business_users (cliente)
  Vita-->>App: verification_status
  App->>Vita: GET /deposits
  Vita-->>App: Métodos para recargar saldo
  Customer->>Bank: Deposita en método virtual
  Bank->>Vita: Notifica el abono
  Vita-->>App: Webhook deposit
  App->>App: Concilia por cliente en tu ledger
  Customer->>App: Solicita retiro
  App->>Vita: POST /transactions (exchange + withdrawal)
```

## Paso a paso

**1. Crea al cliente**

`POST /business_users` y espera la verificación con `GET /business_users/verification_status`.

**2. Consulta sus métodos de depósito**

`GET /deposits` lista los métodos disponibles para recargar saldo en la cuenta del cliente.

**3. Detecta los abonos**

Con webhooks de categoría `deposit` recibes cada depósito acreditado. **Concilia por cliente** en tu sistema usando el identificador del business\_user.

**4. Liquida en moneda local**

Convierte con `exchange` si hace falta y paga con `withdrawal` a la cuenta local del cliente cuando lo solicite.

## Buenas prácticas

> [!TIP]
>
> **Mantén un ledger por cliente**: la wallet de la API es de tu empresa, no de cada cliente. Tu base de datos es la fuente de verdad para los saldos individuales.

> [!TIP]
>
> Concilia con `GET /transactions` filtrando por fechas y, si corresponde, por `source_currency` / `target_currency`.

> [!WARNING]
>
> **Los datos de los clientes viajan por HTTPS y firmados con HMAC.** No los registres en logs ni los expongas en respuestas de tu propia API.

## Endpoints clave

> [card] [Crear usuario](https://docs.vitawallet.io/api-reference/users-creation/overview.md)
>
> `POST /business_users`

> [card] [Métodos de depósito](https://docs.vitawallet.io/api-reference/user-information/overview.md)
>
> `GET /deposits`

> [card] [Transacciones](https://docs.vitawallet.io/api-reference/transactions/overview.md)
>
> `GET /transactions`

> [card] [Webhooks](https://docs.vitawallet.io/api-reference/webhooks/overview.md)
>
> Categoría `deposit`


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