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

# Instalace

> Nainstalujte GoPay SDK (balíček gopay-sdk) a připravte prostředí.

# Instalace

<Tip>
  Dokud nejste připraveni na ostré platby, používejte **sandbox** (`gw.sandbox.gopay.com`) — stejné SDK, jiné `gatewayUrl`.
</Tip>

## Požadavky

* Node.js `>=18`
* Správce balíčků: npm, Yarn nebo pnpm
* Přihlašovací údaje obchodníka GoPay (`goid`, `clientId`, `clientSecret`)

## Instalace z npm

Použijte stejný správce jako ve vaší aplikaci:

<CodeGroup>
  ```bash npm theme={null}
  npm install gopay-sdk
  ```

  ```bash yarn theme={null}
  yarn add gopay-sdk
  ```

  ```bash pnpm theme={null}
  pnpm add gopay-sdk
  ```
</CodeGroup>

## URL prostředí

| Prostředí    | `gatewayUrl`                       |
| ------------ | ---------------------------------- |
| **Sandbox**  | `https://gw.sandbox.gopay.com/api` |
| **Produkce** | `https://gate.gopay.cz/api`        |

<Note>
  SDK **normalizuje** `gatewayUrl` (včetně koncového `/api`), takže např. `https://gw.sandbox.gopay.com` je přijatelné.
</Note>

## Ověření závislosti

```bash theme={null}
npm ls gopay-sdk
```

<Check>
  Měli byste vidět `gopay-sdk@…` bez varování o nadbytečných závislostech.
</Check>

## První import

```ts theme={null}
import { createGoPayClient } from 'gopay-sdk';

const client = createGoPayClient({
  goid: 8123456789,
  clientId: 'client-id',
  clientSecret: 'client-secret',
  gatewayUrl: 'https://gw.sandbox.gopay.com/api',
});

console.log(typeof client.createPayment); // function
```

## Changelog

Historie verzí je v každém vydání. Po instalaci otevřete `node_modules/gopay-sdk/CHANGELOG.md`, nebo soubor v registru: [`CHANGELOG.md`](https://unpkg.com/gopay-sdk@latest/CHANGELOG.md).