HitCTRLHitCTRLWiki
/
Développeurs

Envoyer une conversion

Quand une vente ou une inscription a lieu, votre serveur l’envoie avec la visite ; plus tard il peut changer son statut, par exemple pour un remboursement.

L’appel

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"
}
Champ
hit La visite signée du cookie hitctrl (ou d’une visite côté serveur).
conversionTypeCode Obligatoire. Le code du type de conversion, par exemple sale.
externalId Votre ID de commande ou de transaction. Le même ne compte qu’une fois, réessayer est donc sans risque.
amount.value, currency Le montant de la vente ; nécessaire pour les rémunérations en pourcentage. Une autre devise est convertie au taux du jour.
exchangeRate Votre propre taux vers la devise de l’espace de travail, si votre espace de travail l’accepte.
couponCodes Les codes coupon utilisés ; le partenaire d’un coupon obtient la vente avant la visite.
externalClientId Un client que vous avez enregistré ; la vente compte pour le partenaire de la visite de ce client.
country Le pays de l’acheteur (deux lettres) ; valorise la vente selon celui-ci au lieu du pays de la visite.
customParams.advS1–advS5 Vos propres valeurs ; groupes de rémunération et règles de fraude peuvent les utiliser.
status approved, pending ou test ; omettez-le pour ce que fixe l’objectif de l’offre.

L’un de hit, couponCodes ou externalClientId est obligatoire. L’appel fonctionne aussi en GET avec les mêmes valeurs dans l’adresse.

Changer un statut plus tard

POST https://<your workspace address>/track/conversions/status
{ "externalId": "order-1042", "status": "refunded" }

status vaut approved, pending, rejected ou refunded. Ajoutez conversionTypeCode quand une commande a des conversions de plusieurs types.

Moments chargés

Envoyez l’en-tête Prefer: respond-async : la réponse est 202 tout de suite et la conversion est enregistrée un instant plus tard.

Vérifié dans l’application le 18 octobre 2026