Přejít na hlavní obsah

​
Rychlý start

Tento návod cílí na sandbox. Produkční gatewayUrl a přihlašovací údaje používejte až při ostrém provozu — viz Kontrolní seznam pro produkci.
Postupujte podle kroků a vytvořte platbu v sandboxu pomocí SDK.
1

Přihlašovací údaje

V účtu GoPay vytvořte sandbox údaje a nastavte:
  • GOPAY_CLIENT_ID
  • GOPAY_CLIENT_SECRET
  • obchodní goid
2

Vytvoření klienta

import { createGoPayClient } from 'gopay-sdk';

const client = createGoPayClient({
  goid: 8123456789,
  clientId: process.env.GOPAY_CLIENT_ID!,
  clientSecret: process.env.GOPAY_CLIENT_SECRET!,
  gatewayUrl: 'https://gw.sandbox.gopay.com/api',
});
3

Vytvoření platby

import { Currency } from 'gopay-sdk';

const payment = await client.createPayment({
  amount: 10000, // 100,00 CZK v haléřích
  currency: Currency.CZK,
  order_number: `ORDER-${Date.now()}`,
  payer: {
    contact: {
      email: 'buyer@example.com',
    },
  },
  callback: {
    return_url: 'https://example.com/return',
    notification_url: 'https://example.com/notify',
  },
});
4

Přesměrování na GoPay

if (payment.gw_url) {
  // Z backendu vraťte tuto URL frontendu nebo přesměrujte
  console.log('Přesměrujte uživatele na:', payment.gw_url);
}
5

Dotaz na stav platby

if (payment.id) {
  const details = await client.getPayment(payment.id);
  console.log(details.state, details.sub_state);
}
Částky jsou vždy v minor jednotkách (haléře u CZK). Více v Doporučeních.

​
Další kroky