Stripe Payment Links
Najprostsza integracja z Selgeo — nie wymaga kodu backendowego. Snippet śledzący automatycznie przepisuje Stripe Payment Links na Twojej stronie, dodając click_id, a Selgeo odczytuje go z webhooka Stripe, gdy klient płaci.
Wersja API: v1
Jak działa
Snippet wykrywa wszystkie tagi <a> wskazujące na https://buy.stripe.com/... i dodaje ?client_reference_id=CLICK_ID. Cały przepływ jest automatyczny. Musisz tylko:
- Zainstalować snippet.
- Umieścić Stripe Payment Links na swojej stronie.
- Połączyć Stripe z Selgeo.
Konfiguracja
Krok 1: Zainstaluj snippet
<script
async
src="https://cdn.selgeo.com/v1/selgeo.js"
data-merchant="pk_test_YOUR_KEY"
></script>
Krok 2: Dodaj Stripe Payment Links do strony
<a href="https://buy.stripe.com/test_abc123">Subskrybuj plan Pro</a>
<a href="https://buy.stripe.com/test_def456">Subskrybuj plan Enterprise</a>
Krok 3: Połącz Stripe
W panelu Selgeo przejdź do Ustawienia > Stripe i połącz swoje konto Stripe.
Co przepisuje snippet
Przed:
https://buy.stripe.com/test_abc123
Po (gdy przechowywany jest click_id):
https://buy.stripe.com/test_abc123?client_reference_id=f47ac10b-58cc-4372-a567-0e02b2c3d479
Ochrona przed nadpisaniem przez sprzedawcę
Jeśli sam ustawisz client_reference_id na Payment Link, snippet nie nadpisze Twojej wartości.
Testowanie
- Uzyskaj link śledzący. Linki śledzące tworzą partnerzy w portalu partnerskim (w sekcji Linki), a nie w panelu sprzedawcy — aby przetestować samodzielnie, zaloguj się jako partner testowy i utwórz go.
- Odwiedź swoją stronę za pomocą linku śledzącego:
https://twoja-strona.com/?ref=TWÓJ_REF - Sprawdź Payment Link — kliknij link prawym przyciskiem myszy i wybierz „Zbadaj” lub „Kopiuj adres linku”. Sprawdź, czy
client_reference_idzostał dodany. - Kliknij Payment Link i sfinalizuj zakup, używając karty testowej Stripe
4242 4242 4242 4242. - Sprawdź panel — konwersja powinna pojawić się w Analytics, przypisana do partnera.
Tryb debugowania
Dodaj data-debug do tagu snippetu, aby zobaczyć aktywność przepisywania w konsoli:
[selgeo] Stripe payment link rewritten https://buy.stripe.com/test_abc123?client_reference_id=f47ac10b-...
Ograniczenia
- Wykrywane są tylko linki
buy.stripe.com. - Odwiedzający musi najpierw przybyć przez link śledzący.
- Sesja ograniczona do karty.
sessionStoragejest specyficzny dla karty.
Następne kroki
- Stripe Checkout — jeśli tworzysz sesje płatności po stronie serwera
- Stripe Metadata — używanie metadanych zamiast
client_reference_id - API konwersji — dla konwersji nie-Stripe