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

# Introducción

> Connect API — payment intents, balances, addresses, payouts, transactions y capabilities.

Connect es la API B2B de ZoPay para custodia crypto, depósitos, payouts y atribución por usuario. Todas las rutas viven bajo `/connect/v1`.

Si es tu primera integración, empieza en [Comenzar](/get-started/index).

## Arquitectura

REST + JSON. Cada petición autentica con un token Bearer (`sk_live_…` o `sk_test_…`). La misma clave cubre **toda** la superficie de Connect; el [SDK del navegador](/sdk-reference/index) no usa claves y sólo monta UI a partir de un `payment_intent_id` que tú creaste vía API.

## URL base y modos

* **URL base:** `https://api.zopay.cash/connect/v1`
* **Modo:** lo decide el prefijo de tu clave — `sk_test_...` → `sandbox`, `sk_live_...` → `live` (visible en `GET /health`).

Ambos modos operan **sobre redes reales con dinero real**. La diferencia es aislamiento de datos y disponibilidad de helpers de prueba. Detalle en [Entornos](/get-started/environments).

## Recursos principales

| Recurso                                                                                      | Endpoints                                        |
| -------------------------------------------------------------------------------------------- | ------------------------------------------------ |
| [Payment Intents](/api-reference/endpoints/post-payment-intents)                             | Crear, listar, consultar                         |
| [Addresses](/api-reference/endpoints/post-addresses)                                         | Crear, listar, consultar direcciones de depósito |
| [Balances](/api-reference/endpoints/get-balances)                                            | Consultar saldos por moneda                      |
| [Transactions](/api-reference/endpoints/get-transactions)                                    | Listar y consultar transacciones                 |
| [Payouts](/api-reference/endpoints/post-payouts-quote)                                       | Cotizar y ejecutar payouts on-chain              |
| [Capabilities](/api-reference/endpoints/get-capabilities)                                    | Activos, redes y límites disponibles             |
| [Health](/api-reference/endpoints/get-health)                                                | Verificar autenticación                          |
| [Sandbox helpers](/api-reference/endpoints/post-test-payment-intents-by-id-simulate-deposit) | Simuladores `/test/...` para claves `sk_test_…`  |

## Seguridad

* **Autenticación:** token Bearer con tu clave Connect. Ver [Autenticación](/api-reference/authentication).
* **Idempotencia:** obligatoria en endpoints que crean recursos sensibles (`POST /payment-intents`, `POST /addresses`, `POST /payouts/quote`, `POST /payouts`). Ver [Idempotencia](/api-reference/idempotency).
* **Cuenta aprobada:** los endpoints que mueven fondos exigen organización activa; `GET /health` es la excepción para validar la clave.

## Estado de los endpoints

Algunas rutas (conversions, ramps, webhooks de gestión) están registradas en el spec pero responden `not_yet_available` (501). Lista en [Disponibilidad de endpoints](/get-started/availability).

<Note>
  Para integrar pagos en una web con `@zopay/js`, ve a la pestaña **SDK**. El SDK monta el widget; el intent siempre se crea desde tu servidor con Connect API.
</Note>