Przejdź do głównej treści
SDK umożliwia merchantowi tworzenie płatności w ramach głównego produktu. Każda płatność może zawierać różne dane, takie jak kwota, waluta, identyfikator zewnętrzny (externalId), adres powrotu po płatności (returnUrl) itp. Po utworzeniu płatności SDK zwraca redirectUrl do checkoutu, na którym klient może sfinalizować płatność.
Przed rozpoczęciem integracji przez SDK upewnij się, że masz skonfigurowany produkt i webhook. Przejdź do Konfiguracja, aby wykonać wymagane kroki.

1. Instalacja

npm install @paymove-io/sdk

2. Przykładowe wywołanie

import { PaymoveClient } from "@paymove-io/sdk";

const client = new PaymoveClient({
  apiKey: "pm_sbx_sk_2f38b0c1e74c466db3d1a9b7ff8c41f2",
  merchantId: "2f6c19e8-84a7-4f50-b950-8d5a05e0bbf2",
  environment: "sandbox",
});

const response = await client.createPayment({
  amount: 1000, // w groszach
  currency: "PLN",
  externalId: "order-123",
  returnUrl: "https://merchant-shop.com/payment/success",
  details: {
    productName: "Koszulka sportowa",
    customerId: "user-567",
    returnUrl: "https://merchant-shop.pl/success",
    locale: "pl-PL", // opcjonalnie, nadpisuje locale z głównego produktu
  },
});

console.log(response.redirectUrl);

Parametry konfiguracji

ParametrOpis
apiKeyKlucz autoryzacyjny do API / SDK
merchantIdUUID identyfikujący główny produkt (sklep)
environmentŚrodowisko: "sandbox" lub "production"

Parametry createPayment

ParametrOpis
amountKwota w groszach (np. 1000 = 10,00 PLN)
currencyWaluta (np. "PLN")
externalIdUnikalny identyfikator płatności po stronie merchanta
returnUrlURL powrotu klienta po płatności
details.productNameNazwa produktu widoczna na checkoucie
details.customerIdIdentyfikator klienta w systemie merchanta
details.localeOpcjonalnie - nadpisuje locale z głównego produktu

Odpowiedź

PoleOpis
redirectUrlAdres checkoutu - przekieruj klienta pod ten URL w celu sfinalizowania płatności

3. Przekierowanie klienta

window.location.href = response.redirectUrl;
Po zakończonej płatności klient zostanie automatycznie przekierowany na adres podany w returnUrl. Cały proces płatności jest bezobsługowy - Paymove zarządza checkoutem, przetwarzaniem i przekierowaniem.