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

# Comenzar

> Crea tu cuenta, obtén una clave Connect y elige cómo integrar.

# Comenzar

Documentación para integrar **Zopay Connect** (API REST en `/connect/v1`) y el paquete npm **[`@zopay/js`](https://www.npmjs.com/package/@zopay/js)** (widget de pagos en el navegador).

## Cómo encajan API y SDK

* **Connect API** vive en tu servidor. Crea payment intents, mueve fondos, lee balances. Autentica con una clave `sk_live_…` o `sk_test_…`.
* **`@zopay/js`** vive en el navegador. Monta el widget de pago con el envelope `PaymentIntent` que tu servidor creó. **No usa claves** y nunca habla con ZoPay directo — sus lecturas de estado pasan por tu backend.

La **misma clave** Connect cubre toda la superficie de la API.

## Crear cuenta y clave

<Card title="Cuenta y clave API" icon="key" href="/get-started/account-and-keys">
  Cómo generar tu clave y autenticar peticiones.
</Card>

## Empezar a construir

<CardGroup cols={2}>
  <Card title="Entornos: sandbox vs live" icon="server" href="/get-started/environments">
    Ambos modos sobre redes reales con dinero real. El prefijo de la clave decide aislamiento y helpers.
  </Card>

  <Card title="Verificar autenticación" icon="circle-check" href="/quickstarts/verify-health">
    `GET /connect/v1/health` (no exige cuenta aprobada).
  </Card>

  <Card title="Primer payout" icon="arrow-right" href="/quickstarts/first-payout">
    `POST /payouts/quote` + `POST /payouts`.
  </Card>

  <Card title="Checkout web con SDK" icon="code" href="/quickstarts/checkout-sdk">
    Servidor crea intent → cliente monta widget.
  </Card>
</CardGroup>

## Casos de uso

<CardGroup cols={2}>
  <Card title="Pagos en sitio web (SDK)" icon="globe" href="/get-started/use-cases/checkout-web">
    Botón, payment intents y widget QR.
  </Card>

  <Card title="Enviar fondos (payouts)" icon="send" href="/get-started/use-cases/payouts">
    Cotización y ejecución hacia una dirección on-chain.
  </Card>

  <Card title="Direcciones de depósito" icon="wallet" href="/get-started/use-cases/deposit-addresses">
    Crear y listar direcciones para recibir fondos.
  </Card>

  <Card title="Balances y capacidades" icon="chart-bar" href="/get-started/use-cases/balances-and-capabilities">
    Consultar saldos y qué redes/monedas tiene habilitadas tu cuenta.
  </Card>
</CardGroup>

## Referencia y estado del API

<CardGroup cols={2}>
  <Card title="Disponibilidad de endpoints" icon="list" href="/get-started/availability">
    Qué rutas están operativas hoy y cuáles responden `not_yet_available`.
  </Card>

  <Card title="Errores de la API" icon="triangle-alert" href="/get-started/errors">
    Formato del envelope `{ error: { ... } }` y `doc_url`.
  </Card>

  <Card title="Connect API" icon="book" href="/api-reference/introduction">
    Referencia completa generada desde OpenAPI.
  </Card>

  <Card title="SDK" icon="package" href="/sdk-reference/index">
    `mountPaymentWidget`, `createPoller`, `normalizeIntent`.
  </Card>
</CardGroup>