To jest API V1, które nie jest już utrzymywane

Aby zapoznać się z aktualną dokumentacją, zobacz najnowszą wersję.

Szybki start

W tym przewodniku dowiesz się, jak rozpocząć i skonfigurować płatności oraz jak zbudować płynny proces realizacji zamówienia w Twoim sklepie.

Krok 1: Utwórz konto

Środowisko Sandbox jest niemal repliką środowiska produkcyjnego Paynow, zaprojektowane do celów testowania integracji. Aby uzyskać dostęp do środowiska testowego, musisz zarejestrować się osobno, podając tylko adres e-mail. Po zarejestrowaniu się i utworzeniu sklepu będziesz mieć możliwość wykonywania płatności testowych. Pozwala to symulować różne scenariusze i oceniać funkcjonalność integracji przed jej wdrożeniem w środowisku produkcyjnym.

Aby przetestować nasze środowisko testowe Paynow Sandbox, zarejestruj się tutaj.

Krok 2: Skonfiguruj swój sklep

Podaj adresy URL powiadomień i powrotu. Tutaj możesz również skonfigurować dostępne metody płatności dla swojej integracji.

Krok 3: Utwórz płatność

1. Przygotuj dane do żądania płatności
2. Oblicz podpis dla swojego żądania

Przykładowe wywołanie:

curl --location 'https://api.sandbox.paynow.pl/v1/payments' \
--header 'Content-Type: application/json' \
--header 'Api-Key: {{apiKey}}' \
--header 'Signature: {{signature}}' \
--header 'Idempotency-Key: {{idempotencyKey}}' \
--data-raw '{
  "amount": 100,
  "externalId": 234567898654,
  "description": "Test transaction from quick quide",
  "buyer": {
    "email": "jan.kowalski@melements.pl"
  }
}'

Krok 4: Obsłuż statusy płatności

Podczas procesu płatności Paynow dostarcza asynchroniczne powiadomienia o bieżącym statusie płatności za każdym razem, gdy status zostanie zmieniony. Powiadomienia są wysyłane jako żądanie HTTP POST do podanego adresu powiadomień.

Przykład wiadomości z powiadomieniem:

  curl -X POST \
  <notification URL> \
  -H 'Signature: F69sbjUxBX4eFjfUal/Y9XGREbfaRjh/zdq9j4MWeHM=' \
  -H 'Content-Type: application/json' \
  -d \
  '{
    "paymentId": "NOLV-8F9-08K-WGD",
    "externalId": "9fea23c7-cd5c-4884-9842-6f8592be65df",
    "status": "CONFIRMED",
    "modifiedAt": "2024--06-01T13:24:52"
  }'

Za każdym razem, gdy Paynow wysyła powiadomienie, Twój system musi zweryfikować integralność przychodzącej wiadomości, weryfikując jej nagłówek Signature. Jeśli obliczony Signature nie odpowiada wartości obecnej w nagłówku Signature, nie przetwarzaj tej wiadomości.

Krok 5: Dalej

Teraz kontynuuj i zacznij tworzyć własną aplikację. Możesz użyć naszego SDK lub jednej z już przygotowanych wtyczek do popularnych platform e-commerce.