Jak połączyć Stripe z heyhey

Stripe pozwala przyjmować płatności za Twoje produkty i obsługiwać subskrypcje. W heyhey łączysz własne konto Stripe za pomocą klucza z ograniczonymi uprawnieniami. Nie musisz pisać kodu ani instalować wtyczki. Pieniądze rozliczasz na swoim koncie Stripe, zgodnie z warunkami operatora.

Po wykonaniu tej instrukcji karta Stripe w heyhey powinna pokazywać Połączono, a zakup produktu powinien kończyć się opłaconym zamówieniem i dostępem dla kupującego.

1. Przygotuj konto i otwórz właściwe ustawienia

1. Zaloguj się do swojego konta na stripe.com. Jeśli dopiero je zakładasz, wykonaj kroki aktywacji wskazane przez Stripe. Przygotuj dane sprzedawcy, adres strony i rachunek do wypłat.
2. Upewnij się, że masz dostęp do zarządzania kluczami API. Jeżeli nie widzisz tej sekcji, poproś właściciela konta o odpowiednie uprawnienia.
3. W drugiej karcie otwórz ustawienia płatności heyhey. W panelu znajdziesz je w Sprzedaż → Płatności.
4. Odszukaj kartę Stripe. Zostaw obie karty przeglądarki otwarte, będziesz przenosić między nimi jeden klucz.

API oznacza połączenie między systemami. Klucz API jest poufnym identyfikatorem, który pozwala heyhey wykonywać uzgodnione działania na Twoim koncie Stripe. Nie jest hasłem do logowania.

2. Utwórz klucz z ograniczonymi uprawnieniami

W panelu Stripe przejdź do Developers → API keys. W nowszym układzie wejście do narzędzi deweloperskich może prowadzić przez Workbench. Możesz też otworzyć bezpośrednio API keys.

1. Sprawdź, czy pracujesz na właściwym koncie i w odpowiednim trybie: produkcyjnym do prawdziwej sprzedaży albo testowym do prób.
2. Wybierz Create restricted key, czyli utworzenie klucza z ograniczonym dostępem.
3. Nadaj mu rozpoznawalną nazwę, na przykład heyhey.
4. Jeśli Stripe proponuje gotowe zestawy uprawnień, wybierz własną konfigurację, Choose your own.
5. Ustaw uprawnienia z poniższej tabeli, utwórz klucz i skopiuj jego pełną wartość. Zachowaj go w menedżerze haseł, ponieważ ponowne wyświetlenie może być niedostępne.

Sposób tworzenia klucza i różnice pomiędzy trybami opisuje dokumentacja kluczy Stripe. Poniższy zakres uprawnień odpowiada integracji heyhey.

3. Nadaj dokładnie te uprawnienia

Nazwy w tabeli pozostawiamy w języku panelu Stripe, żeby łatwiej było je odnaleźć.

Prices, Subscriptions, Customer Portal i Invoices szukaj w obszarze Billing, a Accounts w obszarze Connect. Dla pozostałych zasobów pozostaw None, brak dostępu. „Write” obejmuje działania wymagające zapisu, dlatego samo „Read” w tych wierszach nie wystarczy.

4. Wklej klucz w heyhey

1. Wróć do karty Stripe w heyhey.
2. Wklej klucz do pola klucza API. Wartość produkcyjna zaczyna się od rk_live_, testowa od rk_test_.
3. Przy kluczu testowym zaznacz Sandbox / tryb testowy. Przy kluczu produkcyjnym pozostaw ten przełącznik wyłączony.
4. Kliknij Połącz Stripe i poczekaj na wynik sprawdzenia.

Nie wklejaj klucza pk_, pełnego klucza sk_ ani sekretu webhooka whsec_. To inne rodzaje danych, a formularz heyhey wymaga klucza rk_.

heyhey sprawdza klucz i rejestruje webhook, czyli automatyczne powiadomienia ze Stripe. Dzięki nim wie, czy zakup został opłacony, subskrypcja się odnowiła albo wykonano zwrot. Nie musisz ręcznie wpisywać adresu webhooka.

5. Sprawdź status i dostępne metody

Połączono oznacza, że konfiguracja została zaakceptowana. Jeżeli widzisz informację o nieaktywnym koncie, dokończ aktywację w Stripe, a potem użyj przycisku ponownego sprawdzenia w heyhey.

Dla sprzedaży w PLN Stripe może udostępniać także BLIK i Przelewy24. Włącz je w ustawieniach metod płatności Stripe i sprawdź informację o ich dostępności na karcie operatora w heyhey. Dostęp zależy od aktywacji tych metod na Twoim koncie. Przelewy24 przez Stripe i osobne połączenie z Przelewy24 to dwie różne konfiguracje. Do pierwszej nie wklejasz klucza CRC. Jeśli chcesz rozliczać płatności bezpośrednio na koncie Przelewy24, użyj instrukcji połączenia Przelewy24.

Płatność jednorazowa BLIK-iem lub przelewem nie oznacza automatycznie obsługi cyklicznych obciążeń tą samą metodą. Przy subskrypcji sprawdź metodę rzeczywiście dostępną w jej koszyku.

6. Przejdź zakup jak odbiorca

1. Otwórz opublikowany produkt z włączoną sprzedażą i sprawdź cenę oraz walutę.
2. Skopiuj link do koszyka i otwórz go w osobnym oknie przeglądarki.
3. W trybie testowym korzystaj z danych testowych Stripe. Nie używaj prawdziwej karty do testów w sandboxie.
4. Dokończ płatność, wróć do heyhey i sprawdź Sprzedaż → Zamówienia.
5. Sprawdź potwierdzenie zakupu oraz dostęp do produktu z perspektywy kupującego.
6. Przed udostępnieniem koszyka klientom podłącz klucz produkcyjny i upewnij się, że oznaczenie Sandbox zniknęło.

Sam ekran podziękowania nie zastępuje kontroli zamówienia. Jeżeli operator przyjął płatność, a w heyhey nadal jej nie widać, sprawdzenia wymagają powiadomienia o transakcji.

Najczęstsze problemy

Zmiana konta, klucza i pomoc

Odłączenie operatora może przerwać przyjmowanie nowych płatności i obsługę kolejnych rozliczeń. Nie traktuj go jako sposobu na anulowanie subskrypcji klientów. Jeśli przenosisz sprzedaż na inne konto Stripe, nie zakładaj, że stare subskrypcje przeniosą się razem z kluczem. Skontaktuj się z nami przed zmianą.

Jeśli potrzebujesz pomocy, prześlij komunikat błędu, informację „test” lub „produkcja” i numer zamówienia. Nie przesyłaj klucza API ani danych karty. Napisz przez pomoc heyhey.