Testmodus

Selgeo biedt een volledige testomgeving zodat u uw integratie van begin tot eind kunt verifiëren zonder echte betalingen te verwerken of e-mails naar echte partners te sturen. Alle testmodusfuncties gebruiken API-versie v1.

Test vs. live vergelijking

Aspect	Testmodus	Live-modus
API-sleutels	pk_test_*, sk_test_*	pk_live_*, sk_live_*
Gegevens	Volledig geïsoleerd — testgegevens verschijnen nooit in live-rapporten	Productiegegevens
Stripe	Verbindt met uw Stripe-test-omgeving	Verbindt met uw Stripe-live-omgeving
E-mails	Onderdrukt — er worden geen e-mails naar partners of merchants gestuurd	Normaal bezorgd
Webhooks	Bezorgd aan testmodus-eindpunten (HTTPS vereist)	Bezorgd aan live-modus-eindpunten (HTTPS vereist)
Frequentielimieten	Identieke limieten in beide modi	Identieke limieten in beide modi
Fraudedetectie	Actief — dezelfde regels als in live-modus	Actief
AVG-wissing	Volledig functioneel	Volledig functioneel

Gegevensisolatie

Test- en live-modus zijn volledig gescheiden. Partners, klikken, conversies, commissies en webhook-eindpunten die in testmodus zijn aangemaakt, zijn onzichtbaar in live-modus, en omgekeerd. U kunt vrij testscenario's uitvoeren zonder de productiegegevens te beïnvloeden.

Uw testsleutels ophalen

1. Log in op het Selgeo-merchantdashboard.
2. Ga naar Instellingen > API-sleutels.
3. Uw publieke testsleutel (pk_test_*) staat naast de live sleutel. Klik in de testmodus op Geheime sleutel genereren om sk_test_* aan te maken — geheime sleutels ontstaan pas wanneer u ze nodig hebt.

Stapsgewijze testcyclus

Volg deze doorloop om de volledige attributiestroom te verifiëren: klik, attributie, conversie en commissie.

Stap 1 — Het snippet installeren met uw publieke testsleutel

Voeg het Selgeo-trackingsnippet toe aan een testpagina op uw site (of een lokale ontwikkelomgeving). Gebruik uw publieke testsleutel:

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

Stap 2 — Een testpartner aanmaken

Maak in het dashboard een testprogramma aan (of gebruik een bestaand programma) en keur een testpartner goed. Verwijzingslinks worden door partners aangemaakt in het partnerportaal — log in als de testpartner, open Links en maak een link aan. Kopieer de URL ervan. Deze ziet er ongeveer zo uit:

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

Stap 3 — Een klik simuleren

Open de verwijzingslink in uw browser. Het Selgeo-snippet legt de klik vast en maakt een in behandeling zijnde attributie aan. U kunt dit verifiëren in het dashboard onder Analytics > Klikken.

Het snippet slaat een click_id op die deze bezoeker koppelt aan de verwijzende partner.

Stap 4 — Een testconversie melden

Activeer na de gesimuleerde klik een conversie. De methode hangt af van uw integratie:

Stripe Checkout

Voltooi een Stripe-testbetaling met een Stripe-testkaart (bijv. 4242 4242 4242 4242). Selgeo ontvangt de Stripe-webhook en maakt automatisch de conversie aan.

Conversie-API

Stuur een conversie rechtstreeks via de API met uw geheime testsleutel:

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": "DE_CLICK_ID_VAN_STAP_3",
    "event_type": "purchase",
    "external_transaction_id": "test_txn_001",
    "amount_cents": 9900,
    "currency": "EUR"
  }'

Stap 5 — De conversie en commissie verifiëren

1. Ga naar de pagina Analytics in het dashboard. U zou de conversie geregistreerd moeten zien.
2. Ga naar Commissies. Er zou een commissie berekend moeten zijn op basis van de commissieregels van uw programma.
3. Als uw commissieregels een wachtperiode bevatten, staat de commissie in de status pending. Deze wordt automatisch goedgekeurd zodra de wachtperiode is verstreken.

Stap 6 — Webhooks testen

Als u webhook-eindpunten hebt geregistreerd in testmodus, controleer dan het bezorglogboek in Instellingen > Webhooks. U zou bezorgingen moeten zien voor de gebeurtenissen conversion.created en commission.created.

Webhook-eindpunten moeten HTTPS gebruiken en openbaar bereikbaar zijn — ook in testmodus. Voor lokale ontwikkeling stelt u uw lokale server bloot via een tunnel zoals ngrok en registreert u de HTTPS-URL van de tunnel (bijv. https://your-tunnel.ngrok.app/webhooks/selgeo).

Stripe-testomgeving

Selgeo verbindt met uw Stripe-testomgeving wanneer u in testmodus werkt. Dit betekent:

• Testkaartnummers werken zoals verwacht (bijv. 4242 4242 4242 4242 voor een geslaagde betaling)
• Testterugbetalingen activeren commission.refunded-gebeurtenissen
• Testabonnementen genereren terugkerende conversiegebeurtenissen
• Stripe-webhooks uit uw testomgeving worden normaal verwerkt en toegeschreven

Wanneer u uw beperkte Stripe-sleutel voor testmodus verbindt onder Instellingen > Stripe, registreert Selgeo automatisch het testwebhook-eindpunt — u hoeft geen webhook-URL handmatig in Stripe te kopiëren. Zorg ervoor dat de beperkte sleutel de machtiging webhook_endpoints:write bevat.

Stripe-testkaartnummers

Kaartnummer	Gedrag
4242 4242 4242 4242	Slaagt
4000 0000 0000 3220	Vereist 3D Secure-authenticatie
4000 0000 0000 0002	Geweigerd (card_declined)

Zie de testdocumentatie van Stripe voor de volledige lijst.

Testgegevens resetten

Wanneer u met een schone lei wilt beginnen, gebruikt u de knop Testgegevens resetten in het Selgeo-dashboard (pagina Instellingen, testmodus). Hiermee worden alle testmodusgegevens voor uw werkruimte in één actie verwijderd:

• Partners en deelnemers
• Klikken en attributiegebeurtenissen
• Conversies en commissies
• Webhook-bezorglogboeken
• Meldingslogboeken

U kunt ook programmatisch resetten via de API:

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

waarschuwing

Deze actie is onomkeerbaar. Alle testmodusgegevens worden permanent verwijderd.

Tips

• Reset testgegevens regelmatig. Gebruik de resetknop of het bovenstaande API-eindpunt om met een schone lei te beginnen in plaats van afzonderlijke records handmatig op te ruimen.
• Test webhooks vroeg. Stel webhook-eindpunten in testmodus in voordat u live gaat. Controleer of uw server alle gebeurtenistypen verwerkt die u nodig hebt.
• Test randgevallen. Probeer scenario's zoals verlopen attributievensters, dubbele conversies, terugbetalingen en opgeschorte partners om er zeker van te zijn dat uw integratie deze correct afhandelt.
• Controleer de e-mailonderdrukking. Onthoud dat er in testmodus geen e-mails worden verzonden. Als u wilt controleren welke meldingen zouden zijn verzonden, bekijk dan het in-app testmeldingslogboek (de Test-inbox) in het dashboard.
• Wanneer u klaar bent, volg de Live-checklist om over te schakelen naar productie.