Testmodus

Selgeo bietet eine vollständige Testumgebung, mit der Sie Ihre Integration von Anfang bis Ende überprüfen können, ohne echte Zahlungen zu verarbeiten oder E-Mails an echte Partner zu senden. Alle Testmodus-Funktionen verwenden API-Version v1.

Test vs. Live-Vergleich

Aspekt	Testmodus	Live-Modus
API-Schlüssel	pk_test_*, sk_test_*	pk_live_*, sk_live_*
Daten	Vollständig isoliert – Testdaten erscheinen nie in Live-Berichten	Produktionsdaten
Stripe	Verbindet sich mit Ihrer Stripe-Test-Umgebung	Verbindet sich mit Ihrer Stripe-Live-Umgebung
E-Mails	Unterdrückt – keine E-Mails werden an Partner oder Händler gesendet	E-Mails werden normal zugestellt
Webhooks	Werden an Test-Modus-Endpunkte zugestellt (HTTP erlaubt)	Werden an Live-Modus-Endpunkte zugestellt (HTTPS erforderlich)
Rate-Limits	Gleiche Limits wie Live-Modus	Gleiche Limits wie Testmodus
Betrugserkennung	Aktiv – gleiche Regeln wie Live-Modus	Aktiv
DSGVO-Löschung	Voll funktionsfähig	Voll funktionsfähig

Datenisolierung

Test- und Live-Modus sind vollständig getrennt. Partner, Klicks, Konversionen, Provisionen und Webhook-Endpunkte, die im Testmodus erstellt wurden, sind im Live-Modus unsichtbar und umgekehrt. Sie können Testszenarien frei durchführen, ohne Produktionsdaten zu beeinflussen.

Ihre Testschlüssel abrufen

1. Melden Sie sich im Selgeo-Händler-Dashboard an.
2. Navigieren Sie zu Einstellungen > API-Schlüssel.
3. Ihre Testschlüssel (pk_test_* und sk_test_*) werden neben Ihren Live-Schlüsseln angezeigt.

Schritt-für-Schritt-Testzyklus

Folgen Sie dieser Anleitung, um den vollständigen Attributionsfluss zu überprüfen: Klick, Attribution, Konversion und Provision.

Schritt 1 — Snippet mit Ihrem öffentlichen Testschlüssel installieren

Fügen Sie das Selgeo-Tracking-Snippet zu einer Testseite auf Ihrer Website (oder einer lokalen Entwicklungsumgebung) hinzu. Verwenden Sie Ihren öffentlichen Testschlüssel:

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

Schritt 2 — Testpartner erstellen

Erstellen Sie im Dashboard ein Testprogramm (oder verwenden Sie ein vorhandenes) und fügen Sie einen Testpartner hinzu. Notieren Sie die Empfehlungslink- oder Tracking-Link-URL des Partners. Sie sieht ungefähr so aus:

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

Schritt 3 — Einen Klick simulieren

Öffnen Sie den Empfehlungslink in Ihrem Browser. Das Selgeo-Snippet erfasst den Klick und erstellt eine ausstehende Attribution. Sie können dies im Dashboard unter Analytics > Klicks überprüfen.

Das Snippet speichert eine click_id, die diesen Besucher mit dem empfehlenden Partner verknüpft.

Schritt 4 — Eine Testkonversion melden

Lösen Sie nach dem simulierten Klick eine Konversion aus. Die Methode hängt von Ihrer Integration ab:

Stripe Checkout

Schließen Sie einen Stripe-Test-Checkout mit einer Stripe-Testkarte ab (z. B. 4242 4242 4242 4242). Selgeo empfängt den Stripe-Webhook und erstellt die Konversion automatisch.

Conversion API

Senden Sie eine Konversion direkt über die API mit Ihrem geheimen Testschlüssel:

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

Schritt 5 — Konversion und Provision überprüfen

1. Gehen Sie zur Analytics-Seite im Dashboard. Sie sollten die aufgezeichnete Konversion sehen.
2. Navigieren Sie zu Provisionen. Eine Provision sollte basierend auf den Provisionsregeln Ihres Programms berechnet worden sein.
3. Wenn Ihre Provisionsregeln eine Haltefrist beinhalten, befindet sich die Provision im Status ausstehend. Sie wird nach Ablauf der Haltefrist automatisch genehmigt.

Schritt 6 — Webhooks testen

Wenn Sie im Testmodus Webhook-Endpunkte registriert haben, prüfen Sie das Zustellungslog unter Einstellungen > Webhooks. Sie sollten Zustellungen für conversion.created- und commission.created-Ereignisse sehen.

Für die lokale Entwicklung können Sie einen HTTP-Endpunkt registrieren (z. B. http://localhost:3000/webhooks/selgeo). Verwenden Sie ein Tool wie ngrok, um Ihren lokalen Server zugänglich zu machen, wenn Sie nicht auf einer öffentlich zugänglichen URL arbeiten.

Stripe-Testumgebung

Selgeo verbindet sich mit Ihrer Stripe-Testumgebung, wenn es im Testmodus betrieben wird. Das bedeutet:

• Testkartennummern funktionieren wie erwartet (z. B. 4242 4242 4242 4242 für eine erfolgreiche Abbuchung)
• Testrückerstattungen lösen commission.refunded-Ereignisse aus
• Testabonnements generieren wiederkehrende Konversionsereignisse
• Stripe-Webhooks aus Ihrer Testumgebung werden normal verarbeitet und attributiert

Stellen Sie sicher, dass Ihr Stripe-Test-Modus-Webhook-Endpunkt in Stripe konfiguriert ist, um Ereignisse an Selgeo zu senden. Das Selgeo-Dashboard zeigt die genaue Stripe-Webhook-URL unter Einstellungen > Stripe.

Stripe-Testkartennummern

Kartennummer	Verhalten
4242 4242 4242 4242	Erfolgreich
4000 0000 0000 3220	Erfordert 3D-Secure-Authentifizierung
4000 0000 0000 0002	Abgelehnt (card_declined)

Vollständige Liste finden Sie in der Stripe-Testdokumentation.

Testdaten zurücksetzen

Wenn Sie einen sauberen Start möchten, verwenden Sie die Schaltfläche Testdaten zurücksetzen im Selgeo-Dashboard (Einstellungsseite, Testmodus). Dadurch werden alle Testmodus-Daten für Ihren Workspace in einer Aktion gelöscht:

• Partner und Teilnehmer
• Klicks und Attributionsereignisse
• Konversionen und Provisionen
• Webhook-Zustellungslogs
• Benachrichtigungslogs

Sie können auch programmatisch über die API zurücksetzen:

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

warnung

Diese Aktion ist unumkehrbar. Alle Testmodus-Daten werden dauerhaft gelöscht.

Tipps

• Testdaten regelmäßig zurücksetzen. Verwenden Sie die Reset-Schaltfläche oder den API-Endpunkt oben, um von vorne zu beginnen, anstatt einzelne Datensätze manuell zu bereinigen.
• Webhooks früh testen. Richten Sie Webhook-Endpunkte im Testmodus ein, bevor Sie live gehen. Überprüfen Sie, dass Ihr Server alle Ereignistypen verarbeitet, die Sie benötigen.
• Edge Cases testen. Probieren Sie Szenarien wie abgelaufene Attributionsfenster, doppelte Konversionen, Rückerstattungen und gesperrte Partner aus, um sicherzustellen, dass Ihre Integration diese ordnungsgemäß verarbeitet.
• E-Mail-Unterdrückung beachten. Denken Sie daran, dass im Testmodus keine E-Mails gesendet werden. Wenn Sie E-Mail-Templates überprüfen müssen, schauen Sie sich das BullMQ-Queue-Dashboard an (falls in Ihrer Umgebung verfügbar), um in der Warteschlange befindliche Benachrichtigungsaufgaben zu sehen.
• Wenn Sie bereit sind, folgen Sie der Go-Live-Checkliste, um in die Produktion zu wechseln.