W tym artykule
Gdzie: Ustawienia → Czytelnicy i finanse → Integracje → Płatności
Otwórz tę stronę: admin.<your-site>/settings/connections/payments (zastąp <your-site> adresem swojej witryny)
Zanim zaczniesz
- Najpierw połącz Razorpay, Stripe lub PayPal. Zobacz Płatności.
- Musisz mieć uprawnienia właściciela witryny.
Krok po kroku
Stripe i PayPal: jeśli to możliwe, Keynate skonfiguruje powiadomienia w Twoim koncie automatycznie. Na karcie pojawi się wtedy informacja „Powiadomienia o płatnościach w Stripe zostały skonfigurowane automatycznie”. Jeśli automat nie zadziała, zobaczysz komunikat „Jeszcze jeden krok” oraz przycisk Dokończ konfigurację. Wykonaj poniższe kroki.
Razorpay: tej integracji nie da się ustawić automatycznie. Karta Razorpay zawiera przewodnik w 3 krokach ze statusem na żywo: napis Oczekiwanie na pierwszą wiadomość z Razorpay… zmieni się w Otrzymaliśmy pierwszą wiadomość z Razorpay. zaraz po pierwszej płatności — testowej lub prawdziwej. Kliknij Sprawdź teraz, aby sprawdzić ponownie. Zobacz Połącz Razorpay.
Instrukcja dla dowolnej bramki:
- Otwórz Ustawienia → Czytelnicy i finanse → Połączenia → Płatności.
- Na karcie swojej bramki odszukaj sekcję Webhook.
- Kliknij Otwórz webhooki (przycisk zawiera nazwę operatora). Panel bramki otworzy się w nowej karcie.
- W panelu bramki kliknij Dodaj.
- Wróć do Keynate, kliknij Kopiuj obok URL webhooka i wklej go u operatora płatności.
- Zaznacz zdarzenia wymienione w sekcji Keynate.
- Razorpay: kliknij Kopiuj przy tajnym kluczu i wklej go jako secret. Użyj innego klucza w trybie testowym i produkcyjnym.
- Zapisz ustawienia u operatora.
- Stripe i PayPal wygenerują kod po zapisaniu. W Stripe jest to signing secret (zaczyna się od
whsec_). W PayPal jest to Webhook ID. Skopiuj ten kod i wklej w odpowiednie pole w Keynate. - Kliknij Testuj połączenie.
Warto wiedzieć
- Tryb testowy i tryb produkcyjny wymagają osobnych adresów webhook.
- Jeśli zgubisz tajny klucz, utwórz nowy webhook w panelu operatora i wklej nowy kod.
Częste problemy
- „Wklej klucz webhook wprowadzony w Razorpay.” Pole w Keynate jest puste. Wklej dokładnie ten sam klucz, który został wpisany w Razorpay.
- „Użyj innego klucza webhook dla trybu testowego i produkcyjnego.” Wygeneruj osobny klucz dla drugiego trybu.
- „Wklej klucz podpisujący webhook (signing secret). Zaczyna się od whsec_.” Skopiuj go ze Stripe po dodaniu punktu końcowego.
- „Wklej identyfikator Webhook ID (tylko litery i cyfry).” Skopiuj ID z listy webhooków w panelu PayPal.
- Razorpay nadal wyświetla „Oczekiwanie na pierwszą wiadomość z Razorpay…”. Wykonaj małą płatność testową. Powiadomienie dotrze po pierwszej transakcji. Następnie kliknij Sprawdź teraz.
- Zamówienie ma status nieopłaconego, mimo że czytelnik zapłacił. Webhook nie został dodany lub zawiera błąd. Co noc Keynate porównuje zamówienia z danymi bramki i aktualizuje pominięte wpłaty.
Pytania
Najczęściej zadawane pytania
Czy to to samo co klucz API?
Nie. Klucze pozwalają Keynate łączyć się z bramką. Webhook pozwala bramce przekazywać informacje zwrotne do Keynate.
Czy potrzebuję osobnego webhooka do testów i na żywo?
Tak. Tryb testowy i produkcyjny wymagają osobnych konfiguracji.
Co zrobić, jeśli zgubię tajny klucz?
Dodaj nowy webhook w panelu płatności i wklej nowy kod do Keynate.
Co zrobić, jeśli zamówienie wciąż jest nieopłacone po dokonaniu wpłaty?
Webhook nie został dodany lub jest niepoprawny. Co noc Keynate sprawdza zamówienia bezpośrednio w bramce i koryguje zaległe statusy.