Skip to main content

GoPay SDK

Balíček: gopay-sdk na npm — TypeScript klient pro oficiální GoPay REST API, určený pro serverové služby Node.js.
Začínáte? Jděte na InstalaciRychlý start → první sandbox platbu, pak Platby a Zpracování chyb.
SDK řeší OAuth2 tokeny, typované požadavky a odpovědi a celý životní cyklus plateb — vy se soustředíte na logiku produktu.

Přehled

Co můžete stavět

  • Platby — vytváření, dotazování a dokončení checkoutu
  • Refundace — plné nebo částečné refundace a historie
  • Recurrence a autorizace — opakované platby, capture, void
  • Instrumenty a výpisy — platební metody podle měny, exporty účtu
  • Observabilita — vlastní HttpTransport / TokenCache pro tracing a sdílenou cache

Instalace

Přidejte gopay-sdk a nasměrujte sandbox nebo produkční URL brány.

Rychlý start

Sandbox přihlašovací údaje, klient a první createPayment v několika krocích.

Konfigurace

Timeouty, OAuth scope, jazyk, vlastní User-Agent, transport a cache.

Platby

Vytváření plateb, stav, karty a embed helpery.

Chyby

GoPayApiError vs GoPayConfigError, opakování a bezpečné logování.

Doporučení

Produkční vzory: tajemství, částky, idempotence a odolnost.

Požadavky

  • Node.js >=18
  • TypeScript >=5 (doporučeno)

Instalace

Minimální příklad