Go-Live-Checkliste

Folgen Sie dieser Checkliste, wenn Sie bereit sind, vom Test- in den Live-Modus zu wechseln. Schließen Sie jeden Punkt ab, bevor Sie Ihr Programm für echte Partner und Kunden aktivieren. Alle Endpunkte beziehen sich auf API-Version v1.

1. Testschlüssel durch Live-Schlüssel ersetzen

Ersetzen Sie alle Test-API-Schlüssel in Ihrem Code und Ihrer Konfiguration durch ihre Live-Entsprechungen:

Ersetzen	Mit
pk_test_* (im Tracking-Snippet)	pk_live_*
sk_test_* (in server-seitigem Code / Umgebungsvariablen)	sk_live_*

Wo zu prüfen:

• data-merchant-Attribut des Tracking-Snippets in Ihrem HTML/Template
• Server-seitige Umgebungsvariablen für die Conversion API
• CI/CD-Pipeline-Geheimnisse oder Deployment-Konfiguration
• Beliebige Skripte oder Cron-Jobs, die die Selgeo-API aufrufen

gefahr

Übergeben Sie niemals Live-Geheimschlüssel (sk_live_*) an die Versionskontrolle. Verwenden Sie Umgebungsvariablen oder einen Secrets Manager.

2. Stripe-Live-Verbindung überprüfen

1. Gehen Sie im Selgeo-Dashboard zu Einstellungen > Stripe.
2. Bestätigen Sie, dass Ihr Live-Stripe-Konto verbunden ist (nicht nur das Testkonto).
3. Überprüfen Sie den Stripe-Webhook-Endpunkt. Selgeo stellt eine Webhook-URL bereit, die in Ihrem Stripe-Dashboard unter Entwickler > Webhooks für Ihren Live-Modus registriert sein muss. Stellen Sie sicher, dass folgende Ereignisse aktiviert sind:
   • checkout.session.completed
   • invoice.paid
   • charge.refunded
4. Senden Sie ein Testereignis aus dem Stripe-Webhook-Dashboard und bestätigen Sie, dass es im Selgeo-Zustellungslog erscheint.

3. Testdaten entfernen

Testmodus-Daten sind vom Live-Modus isoliert und erscheinen nicht in Live-Berichten. Es ist jedoch eine gute Praxis, aufzuräumen:

• Testpartner entfernen, die nicht übernommen werden sollen
• Testprogramme archivieren oder löschen, die nur für Integrationstests verwendet wurden
• Test-Webhook-Endpunkte löschen, die auf localhost oder Entwicklungs-URLs zeigen

info

Testmodus-Daten beeinflussen Live-Modus-Daten in keiner Weise. Dieser Schritt ist optional, hält Ihr Konto aber ordentlich.

4. Webhook-Endpunkte überprüfen

1. Gehen Sie zu Einstellungen > Webhooks im Dashboard.
2. Erstellen (oder überprüfen) Sie Ihre Live-Modus-Webhook-Endpunkte. Live-Endpunkte müssen HTTPS verwenden.
3. Abonnieren Sie die Ereignisse, die Ihre Anwendung benötigt. Erwägen Sie mindestens:
   • conversion.created — um Konversionen mit Ihrem System zu synchronisieren
   • commission.created — um neue Provisionen zu verfolgen
   • conversion.fraud_detected — um über Betrug benachrichtigt zu werden
   • participant.approved — um Zugriff für neue Partner bereitzustellen
4. Klicken Sie für jeden Endpunkt auf Test-Ping senden, um die Konnektivität zu überprüfen.
5. Speichern Sie das Signierungsgeheimnis (whsec_...) sicher in den Umgebungsvariablen Ihres Servers.
6. Überprüfen Sie, dass Ihr Server Webhook-Signaturen korrekt validiert.

5. Rate-Limits überprüfen

Bestätigen Sie, dass Ihre Integration innerhalb der API-Rate-Limits bleibt:

Zone	Limit
Tracking (POST /v1/clicks)	1.000 Anfragen/Min. pro pk_*-Schlüssel
Conversion API (POST /api/v1/conversions)	120 Anfragen/Min. pro sk_*-Schlüssel
Allgemeine API	300 Anfragen/Min. pro IP-Adresse

Wenn Sie höhere Traffic-Volumina erwarten, kontaktieren Sie den Support, bevor Sie live gehen.

6. Provisionsregeln überprüfen

1. Gehen Sie zu Programme > [Ihr Programm] > Provisionsregeln.
2. Überprüfen Sie, ob Provisionsprozentsätze, Fixbeträge, Haltefristen und Auto-Genehmigungseinstellungen für die Produktion korrekt sind.
3. Wenn Sie Netto-Basis-Provisionen verwenden (Provision nach Stripe-Gebühren berechnet), bestätigen Sie, dass Ihr Stripe-Live-Konto die richtige Gebührenstruktur hat.

7. Den vollständigen Flow noch einmal testen

Bevor Sie Ihr Programm Partnern ankündigen, führen Sie den vollständigen Flow im Live-Modus mit einer echten (aber kleinen) Transaktion durch:

1. Öffnen Sie Ihren Empfehlungslink in einem Browser.
2. Schließen Sie einen echten Kauf ab (Sie können ihn danach zurückerstatten).
3. Überprüfen Sie, ob Klick, Konversion und Provision im Dashboard erscheinen.
4. Überprüfen Sie, ob Webhook-Ereignisse an Ihre Endpunkte zugestellt wurden.
5. Erstatten Sie die Transaktion in Stripe und bestätigen Sie, dass das commission.refunded-Ereignis ausgelöst wird.

8. Ihr Programm aktivieren

1. Setzen Sie den Programmstatus im Dashboard auf Aktiv.
2. Teilen Sie Programm-Einladungslinks oder die Bewerbungsformular-URL mit Ihren Partnern.
3. Überwachen Sie das Dashboard für die ersten echten Partner-Anmeldungen und Konversionen.

Überwachung nach dem Launch

Nach dem Go-Live behalten Sie im Auge:

• Webhook-Zustellungslog — prüfen Sie auf fehlgeschlagene oder Dead-Letter-Zustellungen
• Attributions-Audit-Log — überprüfen Sie Attributionsentscheidungen auf Korrektheit
• Betrugswarnungen — überwachen Sie conversion.fraud_detected-Ereignisse
• Provisions-Überprüfungswarteschlange — genehmigen oder lehnen Sie Provisionen ab, die manuelle Überprüfung erfordern (z. B. Netto-Basis-Provisionen, die mit needs_review markiert sind)