Přejít na hlavní obsah

Platby

Po createPayment přesměrujte zákazníka na gw_url. Notifikace a návrat z prohlížeče berěte jako nápovědu — stav vždy ověřte na serveru pomocí getPayment.
Základní operace vytvoření platby a načtení detailu.

Vytvoření platby

import { Currency, 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',
});

const payment = await client.createPayment({
  amount: 15900,
  currency: Currency.CZK,
  order_number: 'ORDER-15900',
  order_description: 'Premium subscription',
  payer: {
    contact: {
      email: 'buyer@example.com',
      first_name: 'John',
      last_name: 'Doe',
    },
  },
  callback: {
    return_url: 'https://example.com/payment/return',
    notification_url: 'https://example.com/payment/notify',
  },
});

Výchozí hodnoty ze SDK

Pokud vynecháte, SDK doplní:
  • target: { type: 'ACCOUNT', goid: <nakonfigurované goid> }
  • lang: <nakonfigurovaný jazyk klienta>

Detail platby

const details = await client.getPayment(payment.id!);

console.log({
  id: details.id,
  state: details.state,
  subState: details.sub_state,
  amount: details.amount,
  currency: details.currency,
});

Karty — detail a smazání

const card = await client.getCardDetails(123456);
console.log(card.status, card.card_brand, card.card_expiration);

await client.deleteCard(123456);

Embed.js

Pro vložení GoPay UI se stejným prostředím brány:
const embedJsUrl = client.getEmbedJsUrl();
// https://gw.sandbox.gopay.com/gp-gw/js/embed.js

Použité typy

Z exportu gopay-sdk:
  • CreatePaymentRequest
  • PaymentResponse
  • CardDetailsResponse
  • Currency, Language, PaymentInstrument a další enumy