Przejdź do głównej treści
REST API pozwala tworzyć płatności w ramach głównego produktu. Każde wywołanie tworzy płatność, którą klient może opłacić poprzez otrzymany redirectUrl. Po utworzeniu płatności API zwraca redirectUrl do checkoutu, na którym klient może sfinalizować płatność.
Przed rozpoczęciem integracji przez REST API upewnij się, że masz skonfigurowany produkt i webhook. Przejdź do Konfiguracja, aby wykonać wymagane kroki.

1. Endpoint

POST https://gateway-api.sandbox.paymove.io/api/pay/product/{merchantId}/subproduct/pricing

2. Przykładowe wywołanie

const url = `https://gateway-api.sandbox.paymove.io/api/pay/product/${merchantId}/subproduct/pricing`;

const body = {
  price: 1000,
  externalId: "order-123",
  details: {
    currency: "PLN",
    returnUrl: "https://merchant-shop.com/payment/success",
    productName: "Koszulka sportowa",
    customerId: "user-567",
    locale: "pl-PL",
  },
};

const response = await fetch(url, {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-KEY": apiKey,
  },
  body: JSON.stringify(body),
});

const data = await response.json();
console.log(data.redirectUrl);

Nagłówki

NagłówekWartość
Content-Typeapplication/json
X-API-KEYTwój klucz API

Parametry body

PoleOpis
priceKwota w groszach (np. 1000 = 10,00 PLN)
externalIdUnikalny identyfikator płatności po stronie merchanta
details.currencyWaluta
details.returnUrlURL powrotu klienta po płatności
details.productNameNazwa produktu widoczna na checkoucie
details.customerIdIdentyfikator klienta w Twoim systemie
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 = data.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.