Snelstart

Stel uw affiliate-programma in minder dan 30 minuten in. Deze gids legt u uit hoe u het Selgeo-trackingsnippet aan uw website toevoegt, het verbindt met Stripe en uw eerste testconversie verifieert.

API-versie: v1

Vereisten

• Een Selgeo-verkopersaccount
• Toegang tot de HTML van uw website (of een tagbeheerder)
• Een Stripe-account verbonden met Selgeo (voor op Stripe gebaseerde conversietracking)

Stap 1: API-sleutels ophalen

Log in op het Selgeo-verkopersdashboard en navigeer naar Instellingen > API-sleutels. Elke modus heeft zijn eigen sleutelpaar:

Sleuteltype	Formaat	Doel
Publieke sleutel (test)	pk_test_*	JS-snippet op uw website (testmodus)
Publieke sleutel (live)	pk_live_*	JS-snippet op uw website (live-modus)
Geheime sleutel (test)	sk_test_*	Server-side API-aanroepen (testmodus)
Geheime sleutel (live)	sk_live_*	Server-side API-aanroepen (live-modus)

De publieke sleutels staan er vanaf het begin. Geheime sleutels maakt u aan wanneer u die nodig hebt: klik in de gewenste modus op Geheime sleutel genereren. De sleutel wordt maar één keer getoond, kopieer hem dus meteen — een geheime testsleutel kunt u op deze pagina opnieuw tonen met uw wachtwoord, een live-sleutel niet; raakt die kwijt, dan moet u hem roteren.

Publieke sleutels (pk_*) kunnen veilig worden ingesloten in frontend-code. Ze kunnen alleen klikken registreren.

Geheime sleutels (sk_*) mogen nooit worden blootgesteld aan de browser. Gebruik ze alleen op uw server.

Begin met testsleutels

Gebruik pk_test_* en sk_test_* tijdens de integratie. De testmodus volgt alles op dezelfde manier maar maakt geen echte commissies aan. Schakel over naar live sleutels wanneer u klaar bent om live te gaan.

Stap 2: Het trackingsnippet toevoegen

Voeg de volgende <script>-tag toe aan elke pagina van uw website, vlak voor de sluitende </body>-tag:

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

Vervang pk_test_YOUR_KEY door uw werkelijke publieke sleutel uit Stap 1.

Voor uw framework, zie de specifieke handleiding

De <script>-tag hierboven werkt op elke HTML-pagina. Als u op een moderne frontend-stack bouwt, vindt u de equivalente integratie in een van de volgende handleidingen:

• HTML / eenvoudig script — statische sites, tagbeheerders, aangepaste server-gerenderde pagina's.
• Next.js — next/script voor App Router en Pages Router.
• React (Vite) — plaatsing in index.html, met een useEffect-terugvaloptie.
• WordPress — Site Editor, footer.php of een header-footer-plugin.

Wat het snippet doet:

1. Wanneer een bezoeker aankomt via een partnerreferrallink (bijv. https://uw-site.com/?ref=abc123), registreert het snippet de klik bij Selgeo en slaat een click_id op in de sessionStorage van de browser.
2. Als u Stripe Payment Links gebruikt, voegt het snippet automatisch de click_id toe aan die links als client_reference_id — geen backend-werk vereist.
3. Het snippet is cookieloos. Het gebruikt alleen sessionStorage, dat wordt gewist wanneer het browsertabblad wordt gesloten.

Stap 3: Uw installatie verifiëren

1. Haal een verwijzingslink op. Verwijzingslinks worden door partners aangemaakt in het partnerportaal (onder Links), niet in het Selgeo-dashboard. Voor een snelle zelftest logt u als testpartner in op het partnerportaal en maakt u een link aan, of nodigt u een partner uit en vraagt u die om er een aan te maken.
2. Open een nieuw browsertabblad en bezoek uw site via de trackinglink.
3. Open de Ontwikkelaarstools van uw browser (F12) en controleer het tabblad Console. Met data-debug toegevoegd ziet u:

   [selgeo] ref detected UW_TRACKING_REF
   [selgeo] click_id stored xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx

4. Verifieer de click_id door dit uit te voeren in de browserconsole:

   __selgeo.getClickId()

5. Controleer het Selgeo-dashboard — de klik zou binnen enkele seconden zichtbaar moeten zijn in Analytics.

Stap 4: Conversies bijhouden via Stripe

Selgeo ondersteunt drie Stripe-integratiepaden. Kies het pad dat past bij uw configuratie:

Optie A: Stripe Payment Links (geen backend-werk)

Als u Stripe Payment Links (buy.stripe.com-URL's) gebruikt, verwerkt het snippet alles automatisch.

<!-- Uw bestaande Payment Link — het snippet herschrijft het automatisch -->
<a href="https://buy.stripe.com/test_abc123">Nu abonneren</a>

Optie B: Stripe Checkout (één regel frontend-code)

Frontend — lees de klik-ID uit het snippet:

const clickId = __selgeo.getClickId();

fetch('/api/create-checkout', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({ priceId: 'price_xxx', clickId: clickId }),
});

Backend — geef het door als client_reference_id:

JavaScript

const stripe = require('stripe')('sk_test_YOUR_STRIPE_KEY');

app.post('/api/create-checkout', async (req, res) => {
  const session = await stripe.checkout.sessions.create({
    mode: 'subscription',
    line_items: [{ price: req.body.priceId, quantity: 1 }],
    success_url: 'https://uw-site.com/success',
    cancel_url: 'https://uw-site.com/cancel',
    client_reference_id: req.body.clickId || undefined,
  });
  res.json({ url: session.url });
});

Python

import stripe

stripe.api_key = "sk_test_YOUR_STRIPE_KEY"

@app.route("/api/create-checkout", methods=["POST"])
def create_checkout():
    data = request.get_json()
    session = stripe.checkout.Session.create(
        mode="subscription",
        line_items=[{"price": data["priceId"], "quantity": 1}],
        success_url="https://uw-site.com/success",
        cancel_url="https://uw-site.com/cancel",
        client_reference_id=data.get("clickId"),
    )
    return jsonify({"url": session.url})

PHP

$stripe = new \Stripe\StripeClient('sk_test_YOUR_STRIPE_KEY');
$data = json_decode(file_get_contents('php://input'), true);
$session = $stripe->checkout->sessions->create([
    'mode' => 'subscription',
    'line_items' => [['price' => $data['priceId'], 'quantity' => 1]],
    'success_url' => 'https://uw-site.com/success',
    'cancel_url' => 'https://uw-site.com/cancel',
    'client_reference_id' => $data['clickId'] ?? null,
]);
echo json_encode(['url' => $session->url]);

Optie C: Niet-Stripe-conversies (Conversie-API)

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_VAN_FRONTEND",
    "external_transaction_id": "signup_12345",
    "event_type": "signup",
    "amount_cents": 0
  }'

Stap 5: Een conversie end-to-end testen

Doorloop de volledige cyclus in testmodus om te bevestigen dat alles werkt:

1. Maak een testprogramma aan in het Selgeo-dashboard en keur ten minste één partner goed. Laat die partner vervolgens een verwijzingslink aanmaken in het partnerportaal (onder Links).
2. Klik op de verwijzingslink in een nieuw browsertabblad. Dit registreert een klik en slaat een click_id op.
3. Voltooi een aankoop met een van de bovenstaande methoden:
   • Payment Links: Klik op een Stripe Payment Link op uw site. Gebruik Stripe-testkaart 4242 4242 4242 4242.
   • Checkout: Start uw checkout-flow. De click_id wordt doorgegeven als client_reference_id.
   • Conversie-API: Stuur een POST /api/v1/conversions-verzoek vanaf uw server met de click_id.
4. Controleer het dashboard: Ga naar Analytics in het Selgeo-dashboard. U zou moeten zien:
   • De klik geregistreerd onder de partner
   • De conversie toegewezen aan de partner
   • Een berekende commissie (als er commissieregels zijn geconfigureerd)

Stripe-testkaarten

Gebruik de testkaartnummers van Stripe om betalingen te simuleren zonder echte kosten. De meest gebruikte is 4242 4242 4242 4242 met een willekeurige toekomstige vervaldatum en een willekeurige CVC.

Volgende stappen

• Snippet-setup — geavanceerde snippetconfiguratie
• Stripe Metadata — click_id doorgeven via metadata van de betaalsessie
• Conversie-API — volledige API-referentie voor niet-Stripe-conversies
• Testmodus — gedetailleerde gids voor het testen van uw integratie
• Live-checklist — stappen om over te schakelen van testmodus naar live-modus