HitCTRLHitCTRLWiki
/
Sviluppatori

Inviare una conversione

Quando avviene una vendita o un’iscrizione, il tuo server la invia con la visita; dopo può cambiarne lo stato, ad esempio per un rimborso.

La chiamata

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"
}
Campo
hit La visita firmata dal cookie hitctrl (o da una visita lato server).
conversionTypeCode Obbligatorio. Il codice del tipo di conversione, ad esempio sale.
externalId Il tuo ID ordine o transazione. Lo stesso conta una volta, quindi riprovare è sicuro.
amount.value, currency L’importo della vendita; serve per i compensi in percentuale. Un’altra valuta viene convertita al tasso del giorno.
exchangeRate Il tuo tasso verso la valuta del workspace, se il tuo workspace lo accetta.
couponCodes I codici coupon usati; il partner di un coupon ottiene la vendita prima della visita.
externalClientId Un cliente che hai registrato; la vendita conta per il partner della visita di quel cliente.
country Il paese dell’acquirente (due lettere); valuta la vendita in base ad esso invece che al paese della visita.
customParams.advS1–advS5 I tuoi valori; gruppi di compenso e regole antifrode possono usarli.
status approved, pending o test; omettilo per ciò che fissa l’obiettivo dell’offerta.

Uno tra hit, couponCodes ed externalClientId è obbligatorio. La chiamata funziona anche come GET con gli stessi valori nell’indirizzo.

Cambiare uno stato dopo

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

status è approved, pending, rejected o refunded. Aggiungi conversionTypeCode quando un ordine ha conversioni di più tipi.

Momenti di traffico intenso

Invia l’intestazione Prefer: respond-async: la risposta è subito 202 e la conversione viene registrata un istante dopo.

Verificato con l’app il 18 ottobre 2026