Conversie-API

De Conversie-API stelt u in staat om niet-Stripe-conversies aan Selgeo te melden — aanmeldingen, formulierinzendingen, gratis proefversies, upgrades of aangepaste gebeurtenissen. U roept hem aan vanaf uw server nadat een conversie heeft plaatsgevonden, en Selgeo schrijft deze toe aan de verwijzende partner op basis van een click_id of promo_code.

API-versie: v1

Eindpunt: POST /api/v1/conversions

Authenticatie

Authorization: Bearer sk_test_YOUR_KEY

Stel geheime sleutels nooit bloot in frontend-code

Geheime sleutels (sk_*) mogen alleen worden gebruikt in server-side code.

Verzoektekst

Veld	Type	Vereist	Beschrijving
click_id	string (UUID)	Voorwaardelijk	De klik-ID van het trackingsnippet. Vereist als promo_code niet is opgegeven.
promo_code	string	Voorwaardelijk	Een promotiecode voor attributie. Vereist als click_id niet is opgegeven.
external_transaction_id	string	Ja	Uw unieke identificatiecode voor deze conversie. Gebruikt voor deduplicatie. Max 255 tekens.
event_type	string	Ja	Het type conversiegebeurtenis (bijv. signup, purchase, upgrade). Max 100 tekens.
amount_cents	integer	Nee	De conversiewaarde in centen. Standaard: 0.
currency	string	Voorwaardelijk	ISO 4217 3-letterige valutacode. Vereist als amount_cents > 0.
occurred_at	string (ISO 8601)	Nee	Wanneer de conversie heeft plaatsgevonden. Standaard huidige tijd.
prospect_email	string (email)	Nee	Het e-mailadres van de gebruiker die de conversie uitvoert. Gebruikt voor zelf-referralfraude-detectie.
metadata	object	Nee	Willekeurige sleutel-waardeparen. Max 4 KB.

Voorbeeldverzoek

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": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
    "external_transaction_id": "signup_12345",
    "event_type": "signup",
    "amount_cents": 0
  }'

HTTP-statuscodes

Status	Betekenis
201	Conversie succesvol aangemaakt
400	Validatiefout
401	Ongeldige of ontbrekende API-sleutel
409	Dubbele external_transaction_id
422	Geen attributiesignaal of test/live-modus mismatch
429	Frequentielimiet overschreden

Volgende stappen

• Webhooks — meldingen ontvangen wanneer conversies worden toegeschreven
• Testmodus — gedetailleerde testgids voor uw integratie
• Probleemoplossing — veelvoorkomende problemen en oplossingen