# Autenticación (https://dev.cosmospay.lat/docs/es/sdk/server/authentication/)

> Autentícate con una sola clave de API; la red (testnet vs mainnet) se elige automáticamente según el prefijo de la clave.

La autenticación es deliberadamente mínima: una clave de API secreta, guardada en tu servidor. El prefijo de la clave también selecciona testnet o mainnet por ti, así que no hay nada más que configurar. ¿Eres nuevo aquí? Consulta [cómo obtener tu clave de API](https://dev.cosmospay.lat/docs/api-keys/).

**Solo necesitas tu clave de API.** Todo lo demás (URL del gateway, versión de la API) es
parte de la configuración compartida del SDK, mantenida por Cosmos Pay.

```ts
import { Client } from '@cosmosapp/pay_sdk';

const client = new Client({ apiKey: process.env.COSMOS_PAY_API_KEY });
```

La clave de API se envía como `Authorization: Bearer <apiKey>`.

## Selección de red (importante)

La **red se determina según el tipo de clave**; NO la configuras tú:

| Prefijo de clave | Red |
| ---------- | ------- |
| `dv_…`     | testnet |
| `prod_…`   | mainnet |

Por esto, los emisores de activos son específicos de cada red: usa `Assets.*` para mainnet
y `TestnetAssets.*` para testnet (consulta la documentación de activos).

## Mantén la clave en el servidor

La clave de API es un secreto. Crea y valida intenciones en tu **servidor**. El
cliente web del navegador solo firma/envía; no necesita la clave. (*Puede* aceptar
una `apiKey` para prototipos de confianza, pero nunca envíes una clave de producción al navegador).

## Referencias

- [Client](https://dev.cosmospay.lat/docs/sdk/definitions/server/client/): El punto de entrada principal del SDK, un único cliente atómico que expone cada recurso a través de su propio administrador (un diseño atómico de un solo cliente).