# Konfigurationsreferenz (https://dev.cosmospay.lat/docs/de/sdk/server/configuration/)

> Die vollständige Optionsreferenz und die fortgeschrittenen Overrides für das Self-Hosting des Gateways.

Die meisten Integrationen benötigen nichts davon. Hier wird jede Option dokumentiert sowie die fortgeschrittenen Overrides für Self-Hosting oder lokale Entwicklung.

```ts
new Client({
  apiKey: 'prod_xxx',            // required; the only thing you normally set
  webhookSecret: 'whsec_...',    // default secret for the webhook listener
  timeout: 30_000,               // ms (default 30000)
  retries: 2,                    // network errors / 429 / 5xx (default 2)
  headers: { 'X-Trace': 'abc' }, // extra headers on every request
  fetch: customFetch,            // custom fetch implementation

  // Advanced / internal (pre-filled from Client.shared, rarely overridden):
  baseURL: 'https://api.cosmospay.lat/cosmos-api', // gateway URL (default)
  version: 'v1',                 // route prefix
});
```

## Umgebungsvariablen (Konvention)

Das SDK liest selbst nichts aus der Umgebung; Sie übergeben die Werte. Übliche
Konvention, die in der gesamten Dokumentation/in den Beispielen verwendet wird:

| Variable | Verwendet für |
| --- | -------- |
| `COSMOS_PAY_API_KEY` | `new Client({ apiKey })` |
| `COSMOS_WEBHOOK_SECRET` | `new Client({ webhookSecret })` / Handler `{ secret }` |

## Referenzen

- [Client](https://dev.cosmospay.lat/docs/sdk/definitions/server/client/): Der Haupteinstiegspunkt des SDK. Ein einzelner, atomarer Client, der jede Ressource über ihren eigenen Manager bereitstellt (ein atomares Single-Client-Design).