> ## 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.

# Creadores, freelancers y equipos remotos

> Envía pagos masivos a creadores y colaboradores en distintos países desde un saldo central en dólares.

Plataformas de creadores, agencias y empresas con equipos remotos pagan cada mes a cientos de personas en distintos países. Con la API envías todos esos pagos desde un saldo en dólares, y cada persona recibe en su moneda local — o en cripto.

## Flujo

```mermaid theme={null}
sequenceDiagram
  participant App as Tu plataforma
  participant Vita as Vita API
  participant Person as Creador / freelancer

  App->>Vita: GET /wallets/{uuid}
  Vita-->>App: Saldo disponible
  loop Por cada beneficiario
    App->>Vita: GET /prices + /withdrawal_rules
    App->>Vita: POST /transactions (withdrawal)
    Vita-->>App: transaction_id
    Vita-->>Person: Acreditación en banco o cripto
    Vita-->>App: Webhook transaction.completed
  end
  App->>Vita: GET /transactions (reconciliación del lote)
```

## Paso a paso

**1. Fondea tu wallet**

Mantén saldo en dólares. Consúltalo con `GET /wallets/{uuid}` antes de cada lote para no rechazar pagos por saldo insuficiente.

**2. Consulta precio y reglas por país**

`GET /prices` y `GET /withdrawal_rules` por cada destino. **Las reglas cambian por país**: no copies el formulario de uno a otro.

**3. Crea un pago por persona**

`POST /transactions` con `transactions_type: "withdrawal"` y un `order` único por persona y por periodo. Convención sugerida:

```
2026-10-ana-garcia
```

**4. Informa a cada persona**

Escucha `transaction.completed` o `transaction.denied` y avisa a quien cobra. Si un pago se deniega, corrige los datos y reenvía con un `order` nuevo.

## Buenas prácticas

> [!TIP]
>
> Para pagar en **cripto en lugar de banco**, usa `transactions_type: "crypto_payout"` y elige la red con `GET /networks` (respetando `withdraw_min` y sumando `withdraw_fee` al `amount`).

> [!TIP]
>
> Los pagos de una cuenta se procesan en fila: lanza el lote con un **timeout generoso (60–90s)** y no reintentes los que siguen en curso.

> [!TIP]
>
> Valida los datos bancarios con `POST /beneficiaries/validate_beneficiary` **antes** del lote para bajar los rechazos.

## Endpoints clave

> [card] [Saldo de wallet](https://docs.vitawallet.io/api-reference/user-information/overview.md)
>
> `GET /wallets/{uuid}`

> [card] [Crear payout bancario](https://docs.vitawallet.io/api-reference/bank-payouts/create-payout.md)
>
> `POST /transactions` con `transactions_type: "withdrawal"`

> [card] [Crear payout cripto](https://docs.vitawallet.io/api-reference/external-crypto-payouts/create-crypto-payout.md)
>
> `POST /transactions` con `transactions_type: "crypto_payout"`

> [card] [Redes cripto](https://docs.vitawallet.io/api-reference/external-crypto-payouts/overview.md)
>
> `GET /networks`


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