Een conversie sturen
Als er een verkoop of aanmelding is, stuurt je server die met de hit; later kan hij de status veranderen, bijvoorbeeld bij een terugbetaling.
De aanroep
POST https://<your workspace address>/track/conversions
x-api-key: your API key
Content-Type: application/json
{
"hit": "h1.…",
"conversionTypeCode": "sale",
"externalId": "order-1042",
"amount": { "value": 49.90 },
"currency": "EUR"
}
| Veld | |
|---|---|
hit |
De ondertekende hit uit de cookie hitctrl (of uit een server-side hit). |
conversionTypeCode |
Verplicht. De code van het conversietype, bijvoorbeeld sale. |
externalId |
Je bestel- of transactie-ID. Dezelfde telt één keer, dus herhalen is veilig. |
amount.value, currency |
Het verkoopbedrag; nodig voor uitbetalingen in procenten. Een andere valuta wordt omgerekend tegen de dagkoers. |
exchangeRate |
Je eigen koers naar de valuta van de workspace, als je workspace die accepteert. |
couponCodes |
Gebruikte kortingscodes; de partner van een code krijgt de verkoop vóór de hit. |
externalClientId |
Een klant die je registreerde; de verkoop telt voor de partner van de hit van die klant. |
country |
Het land van de koper (twee letters); prijst de verkoop daarop in plaats van op het land van de hit. |
customParams.advS1–advS5 |
Je eigen waarden; uitbetaalgroepen en frauderegels kunnen ze gebruiken. |
status |
approved, pending of test; laat weg voor wat het doel van de aanbieding instelt. |
Eén van hit, couponCodes of externalClientId is verplicht. De aanroep werkt ook als GET met dezelfde waarden in het adres.
Later een status veranderen
POST https://<your workspace address>/track/conversions/status
{ "externalId": "order-1042", "status": "refunded" }
status is approved, pending, rejected of refunded. Voeg conversionTypeCode toe als één bestelling conversies van meerdere typen heeft.
Drukke momenten
Stuur de header Prefer: respond-async: het antwoord is meteen 202 en de conversie wordt even later vastgelegd.
Heeft dit je vraag beantwoord?
Gecontroleerd met de app op 18 oktober 2026