Tryb testowy

Selgeo zapewnia pełne środowisko testowe, dzięki któremu możesz zweryfikować swoją integrację od początku do końca bez przetwarzania prawdziwych płatności ani wysyłania e-maili do prawdziwych partnerów. Wszystkie funkcje trybu testowego używają API wersji v1.

Porównanie test vs. live

Aspekt	Tryb testowy	Tryb live
Klucze API	pk_test_*, sk_test_*	pk_live_*, sk_live_*
Dane	Całkowicie izolowane — dane testowe nigdy nie pojawiają się w raportach trybu live	Dane produkcyjne
Stripe	Łączy się z Twoim środowiskiem testowym Stripe	Łączy się z Twoim środowiskiem live Stripe
E-maile	Wstrzymane — do partnerów ani merchantów nie są wysyłane żadne e-maile	Dostarczane normalnie
Webhooki	Dostarczane do punktów końcowych trybu testowego (wymagany HTTPS)	Dostarczane do punktów końcowych trybu live (wymagany HTTPS)
Limity szybkości	Identyczne limity w obu trybach	Identyczne limity w obu trybach
Wykrywanie oszustw	Aktywne — te same reguły co w trybie live	Aktywne
Usuwanie danych (RODO)	W pełni funkcjonalne	W pełni funkcjonalne

Izolacja danych

Tryby testowy i live są całkowicie rozdzielone. Partnerzy, kliknięcia, konwersje, prowizje i punkty końcowe webhooków utworzone w trybie testowym są niewidoczne w trybie live i odwrotnie. Możesz swobodnie uruchamiać scenariusze testowe bez wpływu na dane produkcyjne.

Pobieranie kluczy testowych

1. Zaloguj się do panelu handlowca Selgeo.
2. Przejdź do Ustawienia > Klucze API.
3. Twój publiczny klucz testowy (pk_test_*) jest wyświetlany obok klucza live. Kliknij Generuj tajny klucz w trybie testowym, aby wydać sk_test_* — klucze tajne powstają na żądanie, a nie z góry.

Cykl testowy krok po kroku

Wykonaj ten przewodnik, aby zweryfikować pełny przepływ atrybucji: kliknięcie, atrybucję, konwersję i prowizję.

Krok 1 — Zainstaluj snippet z publicznym kluczem testowym

Dodaj snippet śledzący Selgeo do strony testowej w swojej witrynie (lub w lokalnym środowisku programistycznym). Użyj swojego publicznego klucza testowego:

<script
  src="https://cdn.selgeo.com/v1/selgeo.js"
  data-merchant="pk_test_YOUR_KEY"
  async
></script>

Krok 2 — Utwórz partnera testowego

W panelu utwórz program testowy (lub użyj istniejącego) i zatwierdź partnera testowego. Linki polecające tworzą partnerzy w portalu partnerskim — zaloguj się jako partner testowy, otwórz Linki i utwórz link. Skopiuj jego adres URL. Będzie wyglądał podobnie do:

https://twojastrona.com/?ref=abc123

Krok 3 — Symuluj kliknięcie

Otwórz link polecający w przeglądarce. Snippet Selgeo rejestruje kliknięcie i tworzy oczekującą atrybucję. Możesz to zweryfikować w panelu w sekcji Analityka > Kliknięcia.

Snippet zapisuje click_id, który wiąże tego odwiedzającego z polecającym partnerem.

Krok 4 — Zgłoś konwersję testową

Po symulowanym kliknięciu wywołaj konwersję. Metoda zależy od Twojej integracji:

Stripe Checkout

Dokończ testową płatność Stripe używając karty testowej Stripe (np. 4242 4242 4242 4242). Selgeo odbiera webhook Stripe i automatycznie tworzy konwersję.

API konwersji

Wyślij konwersję bezpośrednio przez API, używając swojego tajnego klucza testowego:

curl -X POST https://app.selgeo.com/api/v1/conversions \
  -H "Authorization: Bearer sk_test_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "click_id": "CLICK_ID_Z_KROKU_3",
    "event_type": "purchase",
    "external_transaction_id": "test_txn_001",
    "amount_cents": 9900,
    "currency": "EUR"
  }'

Krok 5 — Zweryfikuj konwersję i prowizję

1. Przejdź do strony Analityka w panelu. Powinieneś zobaczyć zarejestrowaną konwersję.
2. Przejdź do sekcji Prowizje. Prowizja powinna zostać obliczona na podstawie zasad prowizji Twojego programu.
3. Jeśli Twoje zasady prowizji obejmują okres wstrzymania, prowizja będzie w stanie pending. Zostanie automatycznie zatwierdzona po upływie okresu wstrzymania.

Krok 6 — Przetestuj webhooki

Jeśli masz zarejestrowane punkty końcowe webhooków w trybie testowym, sprawdź dziennik dostarczania w Ustawienia > Webhooki. Powinieneś zobaczyć dostarczenia zdarzeń conversion.created i commission.created.

Punkty końcowe webhooków muszą używać HTTPS i być publicznie dostępne — również w trybie testowym. W przypadku lokalnego środowiska programistycznego udostępnij swój lokalny serwer przez tunel taki jak ngrok i zarejestruj adres HTTPS tunelu (np. https://your-tunnel.ngrok.app/webhooks/selgeo).

Środowisko testowe Stripe

W trybie testowym Selgeo łączy się z Twoim środowiskiem testowym Stripe. Oznacza to, że:

• Numery kart testowych działają zgodnie z oczekiwaniami (np. 4242 4242 4242 4242 dla udanej płatności)
• Testowe zwroty wyzwalają zdarzenia commission.refunded
• Testowe subskrypcje generują cykliczne zdarzenia konwersji
• Webhooki Stripe z Twojego środowiska testowego są przetwarzane i przypisywane normalnie

Gdy podłączysz swój klucz z ograniczeniami Stripe w trybie testowym w Ustawienia > Stripe, Selgeo automatycznie rejestruje testowy punkt końcowy webhooka — nie musisz ręcznie kopiować adresu URL webhooka do Stripe. Upewnij się, że klucz z ograniczeniami zawiera uprawnienie webhook_endpoints:write.

Numery testowych kart Stripe

Numer karty	Zachowanie
4242 4242 4242 4242	Powodzenie
4000 0000 0000 3220	Wymaga uwierzytelnienia 3D Secure
4000 0000 0000 0002	Odrzucona (card_declined)

Pełną listę znajdziesz w dokumentacji testowej Stripe.

Resetowanie danych testowych

Gdy chcesz zacząć od czystej karty, użyj przycisku Resetuj dane testowe w panelu Selgeo (strona Ustawienia, tryb testowy). Usuwa to wszystkie dane trybu testowego Twojego obszaru roboczego w jednej operacji:

• Partnerów i uczestników
• Kliknięcia i zdarzenia atrybucji
• Konwersje i prowizje
• Dzienniki dostarczania webhooków
• Dzienniki powiadomień

Możesz również zresetować dane programowo przez API:

curl -X DELETE https://app.selgeo.com/api/v1/workspace/test-data \
  -H "Authorization: Bearer YOUR_JWT_TOKEN"

ostrzeżenie

Ta operacja jest nieodwracalna. Wszystkie dane trybu testowego zostaną trwale usunięte.

Wskazówki

• Regularnie resetuj dane testowe. Użyj przycisku resetowania lub powyższego punktu końcowego API, aby zacząć od nowa, zamiast ręcznie usuwać poszczególne rekordy.
• Testuj webhooki wcześnie. Skonfiguruj punkty końcowe webhooków w trybie testowym przed uruchomieniem. Sprawdź, czy Twój serwer obsługuje wszystkie potrzebne Ci typy zdarzeń.
• Testuj przypadki graniczne. Wypróbuj scenariusze takie jak wygasłe okna atrybucji, zduplikowane konwersje, zwroty i zawieszeni partnerzy, aby upewnić się, że Twoja integracja radzi sobie z nimi bez problemu.
• Sprawdź wstrzymywanie e-maili. Pamiętaj, że w trybie testowym nie są wysyłane żadne e-maile. Jeśli chcesz sprawdzić, które powiadomienia zostałyby wysłane, zajrzyj do wbudowanego dziennika powiadomień testowych (Skrzynka testowa) w panelu.
• Gdy będziesz gotowy, postępuj zgodnie z Listą kontrolną uruchomienia, aby przełączyć się na produkcję.