Start - Dokumentacja Techniczna

Z bramką płatniczą Paymove przyjmowanie płatności online jest proste. Jako sprzedawca inicjujesz transakcję przez nasze API lub SDK, a Twój klient opłaca ją na bezpiecznej, gotowej stronie płatności. Gdy tylko pieniądze zostaną wpłacone, Twój system natychmiast otrzyma automatyczne powiadomienie.

Gotową integrację możesz przetestować w demo sklepie Paymove.

Jak działa płatność?

Krok	Kto	Co się dzieje
1	Twój serwer	Wywołuje API Paymove z kwotą, `externalId` i `returnUrl`
2	Paymove	Zwraca `redirectUrl` - adres strony checkoutu
3	Klient	Zostaje przekierowany na checkout i podaje dane płatności
4	Paymove	Wysyła podpisany webhook na zarejestrowany URL - domyślnie tylko dla statusu `COMPLETED`
5	Twój serwer	Weryfikuje podpis, odpowiada `{ "status": "ok" }` i realizuje zamówienie
6	Klient	Widzi ekran potwierdzenia i może kliknąć „Wróć do sklepu”, co przenosi go na `returnUrl`

Zamówienie realizuj wyłącznie po zweryfikowanym webhooku (krok 5), nigdy po powrocie klienta na returnUrl (krok 6). Krok 6 wymaga kliknięcia i może nie nastąpić wcale, a sam returnUrl można otworzyć bez opłacenia zamówienia.

Co potrzebujesz do integracji

Dane	Format	Opis
`apiKey`	`sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`	Klucz autoryzacyjny przekazywany w nagłówku `X-API-KEY`. Sandbox: `sk_test_`, produkcja: `sk_live_`
`productId`	`2f6c19e8-84a7-4f50-b950-8d5a05e0bbf2`	UUID identyfikujący Twój sklep w systemie Paymove

Klucz API i productId wygenerujesz w Panelu Paymove.