Přejít na hlavní obsah

​
Metody klienta

Stručná mapa z metod SDK na HTTP endpointy. Typy požadavků, odpovědí a enumy viz Typy a enumy.
Všechny metody níže jsou na GoPayClient z createGoPayClient(...). 
import { createGoPayClient } from 'gopay-sdk';

​
Platby

​
createPayment(payment)

  • Endpoint: POST /payments/payment
  • Návrat: Promise<PaymentResponse>
  • Chování: výchozí hodnoty pro:
    • target -> { type: 'ACCOUNT', goid: <nakonfigurované goid> }
    • lang -> jazyk klienta

​
getPayment(paymentId)

  • Endpoint: GET /payments/payment/{id}
  • Návrat: Promise<PaymentResponse>

​
refundPayment(paymentId, { amount })

  • Endpoint: POST /payments/payment/{id}/refund
  • Content-Type: application/x-www-form-urlencoded
  • Návrat: Promise<PaymentOperationResponse>

​
getPaymentRefunds(paymentId)

  • Endpoint: GET /payments/payment/{id}/refunds
  • Návrat: Promise<RefundHistoryItem[]>

​
Recurrence a preautorizace

​
createRecurrence(paymentId, request)

  • Endpoint: POST /payments/payment/{id}/create-recurrence
  • Návrat: Promise<PaymentResponse>

​
voidRecurrence(paymentId)

  • Endpoint: POST /payments/payment/{id}/void-recurrence
  • Návrat: Promise<PaymentOperationResponse>

​
captureAuthorization(paymentId)

  • Endpoint: POST /payments/payment/{id}/capture
  • Návrat: Promise<PaymentOperationResponse>

​
captureAuthorizationPartial(paymentId, request)

  • Endpoint: POST /payments/payment/{id}/capture
  • Návrat: Promise<PaymentOperationResponse>

​
voidAuthorization(paymentId)

  • Endpoint: POST /payments/payment/{id}/void-authorization
  • Návrat: Promise<PaymentOperationResponse>

​
Karty

​
getCardDetails(cardId)

  • Endpoint: GET /payments/cards/{card_id}
  • Návrat: Promise<CardDetailsResponse>

​
deleteCard(cardId)

  • Endpoint: DELETE /payments/cards/{card_id}
  • Návrat: Promise<void>
  • Očekávaný stav: 204 No Content

​
Platební metody

​
getPaymentInstruments(goid, currency)

  • Endpoint: GET /eshops/eshop/{goid}/payment-instruments/{currency}
  • Návrat: Promise<PaymentInstrumentsResponse>

​
getPaymentInstrumentsAll(goid)

  • Endpoint: GET /eshops/eshop/{goid}/payment-instruments
  • Návrat: Promise<PaymentInstrumentsAllResponse>

​
Výpisy z účtu

​
getAccountStatement(request)

  • Endpoint: POST /accounts/account-statement
  • Návrat: Promise<AccountStatementResponse>
  • Tvar odpovědi:
type AccountStatementResponse = {
  data: ArrayBuffer;
  contentType: string | null;
  contentDisposition: string | null;
  toText(encoding?: string): string;
};

​
Pomocné

​
getEmbedJsUrl()

  • Vrací URL embed skriptu pro nakonfigurovanou bránu:
    • sandbox -> https://gw.sandbox.gopay.com/gp-gw/js/embed.js
    • produkce -> https://gate.gopay.cz/gp-gw/js/embed.js