Utwórz płatność
Tworzy płatność 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ść.
Autoryzacje
Klucz API generowany w Panelu Paymove.
Format: 51 znaków z prefiksem środowiska - sk_test_ w sandboxie,
sk_live_ na produkcji.
Przykład: sk_test_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Klucz przekazuj wyłącznie z serwera. Żądanie wysłane ze strony sklepu zostanie odrzucone - a klucz i tak nigdy nie może trafić do kodu frontendowego.
Parametry ścieżki
UUID produktu (sklepu) otrzymany przy jego tworzeniu
"891412c8-8717-4449-9543-e34112bec470"
Treść
Kwota w groszach jako liczba całkowita (1000 = 10,00 PLN). Bramka rozlicza wyłącznie w PLN. UWAGA: wartość z częścią dziesiętną (np. 12.99) zostanie po cichu obcięta do 12 groszy, a API i tak zwróci 200 - przeliczaj przez Math.round(kwota * 100).
1000
Unikalny identyfikator płatności po stronie merchanta (orderId). Ponowne użycie tej samej wartości nie tworzy nowej płatności - API zwraca 200 z redirectUrl płatności utworzonej wcześniej, a nowa cena i pozostałe pola są odrzucane.
"order-123"
Swobodny obiekt danych płatności. Możesz przekazać własne pola - zostaną zachowane, ale checkout odczytuje wyłącznie: returnUrl, redirectUrl, productName, email, locale, orderId, recipient, triggerPayment, qrStepEnabled i autoclose.
Opcjonalnie - rachunek, na który Paymove wypłaci środki z tej płatności. Nadpisuje rachunek produktu; pominięty oznacza rachunek produktu. To nie jest rachunek, na który płaci klient. Przy powtórzonym externalId pole jest ignorowane.
Przestarzałe - sam IBAN jako tekst, działa jak bankAccountDetails.iban. Wysyła go SDK. W nowych integracjach używaj bankAccountDetails; gdy podasz oba pola, obowiązuje bankAccountDetails.
"PL61109010140000071219812874"
Odpowiedź
Płatność utworzona pomyślnie
Adres checkoutu - przekieruj klienta pod ten URL w celu sfinalizowania płatności. Parametr externalId w tym adresie to wygenerowany przez Paymove 10-znakowy skrót płatności, a NIE externalId przekazany w żądaniu. To jego używasz przy sprawdzaniu statusu płatności.