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 (HTTPS erforderlich)	Werden an Live-Modus-Endpunkte zugestellt (HTTPS erforderlich)
Rate-Limits	In beiden Modi identische Limits	In beiden Modi identische Limits
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. Ihr öffentlicher Testschlüssel (pk_test_*) wird neben dem Live-Schlüssel angezeigt. Klicken Sie im Testmodus auf Geheimschlüssel generieren, um sk_test_* zu erstellen — geheime Schlüssel entstehen erst bei Bedarf.

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://app.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.

Webhook-Endpunkte müssen HTTPS verwenden und öffentlich erreichbar sein — auch im Testmodus. Machen Sie für die lokale Entwicklung Ihren lokalen Server über einen Tunnel wie ngrok zugänglich und registrieren Sie die HTTPS-URL des Tunnels (z. B. https://ihr-tunnel.ngrok.app/webhooks/selgeo).

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

Wenn Sie Ihren eingeschränkten Stripe-Schlüssel für den Testmodus unter Einstellungen > Stripe verbinden, registriert Selgeo den Test-Webhook-Endpunkt automatisch — Sie müssen keine Webhook-URL manuell in Stripe kopieren. Stellen Sie sicher, dass der eingeschränkte Schlüssel die Berechtigung webhook_endpoints:write enthält.

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://app.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 überprüfen möchten, welche Benachrichtigungen gesendet worden wären, schauen Sie sich das In-App-Testbenachrichtigungslog (den Test-Posteingang) im Dashboard an.
• Wenn Sie bereit sind, folgen Sie der Go-Live-Checkliste, um in die Produktion zu wechseln.