PayPal możesz podłączyć do heyhey, aby odbierać płatności na własne konto PayPal. Połączenie wymaga dwóch danych aplikacji: Client ID oraz Secret. Nie podajesz w heyhey hasła do PayPal i nie instalujesz dodatkowej wtyczki.
Ta instrukcja prowadzi od utworzenia aplikacji do sprawdzenia zakupu. Obejmuje też osobne potwierdzenie gotowości subskrypcji, ponieważ samo połączenie płatności jednorazowych nie zawsze oznacza, że powiadomienia o subskrypcjach są już aktywne.
1. Przygotuj konto PayPal
Przygotuj konto sprzedawcy PayPal Business i dostęp do jego panelu deweloperskiego. Jeśli dopiero zaczynasz, uzupełnij wymagane przez PayPal dane i sprawdź, czy konto może przyjmować płatności. Weryfikacja konta odbywa się po stronie PayPal, heyhey jej nie zastępuje.
Otwórz dwie karty:
- PayPal Developer, tutaj utworzysz aplikację i skopiujesz jej dane;
- Sprzedaż → Płatności w heyhey, tutaj zapiszesz połączenie.
Aplikacja w panelu PayPal to nazwa konfiguracji dostępu dla heyhey. Nie oznacza, że masz samodzielnie budować aplikację mobilną czy programować integrację.
2. Utwórz aplikację i wybierz środowisko
- Zaloguj się do panelu PayPal Developer kontem powiązanym z Twoją sprzedażą.
- Wejdź w Apps & Credentials.
- Wybierz Live, jeśli przygotowujesz prawdziwą sprzedaż, albo Sandbox, jeśli robisz próbę.
- Kliknij Create App. Nadaj aplikacji nazwę heyhey. Jeśli formularz pyta o typ, dla własnej sprzedaży wybierz aplikację sprzedawcy, Merchant.
- Otwórz utworzoną aplikację i odszukaj Client ID oraz Secret / Client secret. Sekret może wymagać odsłonięcia przyciskiem w panelu.
Instrukcja tworzenia danych REST API w PayPal opisuje rozdzielenie Live i Sandbox. Klucze pochodzące z jednego środowiska nie służą do obsługi drugiego.
3. Przepisz dane do właściwych pól heyhey
Na stronie płatności heyhey odszukaj kartę PayPal.
| Pole w heyhey | Co wkleić | Czego tu nie wpisywać |
|---|---|---|
| Client ID | Identyfikator utworzonej aplikacji PayPal | Adresu e-mail ani identyfikatora sprzedawcy |
| Secret | Sekret tej samej aplikacji | Hasła do konta ani danych innej aplikacji |
| Sandbox / tryb testowy | Włącz wyłącznie dla danych Sandbox | Nie włączaj przy danych Live |
- Skopiuj cały Client ID i wklej go do pierwszego pola.
- Skopiuj Secret z tej samej aplikacji i wklej go do drugiego pola.
- Sprawdź przełącznik Sandbox.
- Kliknij przycisk połączenia z PayPal.
- Poczekaj na komunikat i status na karcie operatora.
Najczęstszym błędem jest połączenie Client ID z jednej aplikacji z sekretem drugiej. Dlatego kopiuj oba pola podczas jednego otwarcia szczegółów aplikacji.
4. Sprawdź także powiadomienia i subskrypcje
heyhey weryfikuje dane aplikacji i próbuje zarejestrować webhook. Webhook to automatyczna wiadomość od PayPal do heyhey o zmianie płatności lub subskrypcji. Dzięki niemu stan zamówienia może zostać zaktualizowany również wtedy, gdy kupujący zamknął przeglądarkę.
Na karcie możesz zobaczyć dwa różne wyniki:
- Połączono i subskrypcje włączone: połączenie oraz wymagane powiadomienia są gotowe.
- Płatności jednorazowe działają, subskrypcje nie są gotowe: PayPal nie zaakceptował jeszcze rejestracji webhooka. Użyj widocznego na karcie przycisku ponowienia. Jeśli problem wraca, sprawdź dostęp aplikacji do potrzebnych funkcji i skontaktuj się z pomocą heyhey.
Nie twórz na chybił trafił kilku identycznych webhooków. heyhey rejestruje swój punkt odbioru automatycznie. Przy rozwiązywaniu problemu ważny jest wynik tej rejestracji, a nie samo pojawienie się logo PayPal w koszyku.
5. Wykonaj test płatności jednorazowej
- Otwórz swój produkt, ustaw cenę i włącz sprzedaż. Użyj produktu, do którego potrafisz sprawdzić dostęp, na przykład e-booka.
- Otwórz link do koszyka poza sesją edycji i wybierz PayPal.
- Dokończ próbę kontem kupującego odpowiednim dla środowiska. W Sandbox używa się testowego konta kupującego, oddzielnego od testowego sprzedawcy.
- Wróć do Sprzedaż → Zamówienia w heyhey i odnajdź zakup po adresie e-mail.
- Porównaj stan zamówienia z transakcją w PayPal. Następnie sprawdź wiadomość zakupową oraz dostęp do materiału.
PayPal opisuje przygotowanie aplikacji i danych testowych w przewodniku rozpoczęcia integracji. Przed rozpoczęciem sprzedaży podłącz dane Live, wyłącz Sandbox i ponownie sprawdź status.
6. Jeśli sprzedajesz subskrypcję
Wybierz produkt z ceną cykliczną i sprawdź cały zakup oddzielnie od płatności jednorazowej. Karta PayPal powinna wskazywać gotowość subskrypcji. Po zatwierdzeniu zakupu sprawdź, czy heyhey utworzyło subskrypcję klienta i nadało dostęp.
Nie traktuj pojedynczego udanego zakupu e-booka jako testu subskrypcji. To inny przepływ płatności. Przy problemie zapisz numer zamówienia, identyfikator subskrypcji i dokładny moment próby.
Najczęstsze problemy
| Problem | Następny krok |
|---|---|
| Dane nie przechodzą weryfikacji | Skopiuj Client ID i Secret ponownie z jednej aplikacji i sprawdź Live/Sandbox |
| Konto działa w teście, a nie przy sprzedaży | Podłącz dane aplikacji Live i upewnij się, że konto jest gotowe do odbierania płatności |
| Subskrypcje nie są gotowe | Ponów rejestrację webhooka z karty PayPal w heyhey |
| Kupujący wrócił na stronę, ale zakup nie jest opłacony | Porównaj transakcję w PayPal ze statusem zamówienia, sam powrót nie potwierdza zapłaty |
| Płatność jest w PayPal, a materiału nie ma | Sprawdź powiadomienia, zamówienie i przypisany produkt, zgłoś numery rekordów do pomocy |
| PayPal nie pojawia się przy konkretnym produkcie | Sprawdź konfigurację sprzedaży, walutę i stan połączenia dla tego konta heyhey |
Co z wypłatami, opłatami i odłączeniem?
Środkami i wypłatami zarządzasz w PayPal. Opłaty operatora wynikają z warunków Twojego konta, samo podłączenie heyhey nie zmienia tej umowy.
Nie odłączaj aplikacji z aktywnymi subskrypcjami tylko po to, aby zmienić nazwę lub sprawdzić ustawienia. Usunięcie dostępu może zakłócić rozliczenia. Zmianę aplikacji lub konta najlepiej wcześniej uzgodnić z pomocą heyhey. W zgłoszeniu nie podawaj Secret ani hasła do PayPal.
Więcej w kategorii Operatory sprzedaży
Jak połączyć Stripe z heyhey Jak połączyć Tpay z heyhey Jak połączyć PayU z heyhey Jak połączyć Przelewy24 z heyhey