Konverterings-API

Alle salg fra track.js ender i det samme endpoint. Bygger I selv integrationen – fx fra jeres egen backend, når betalingen er gennemført – kan I kalde det direkte.

POST https://app.affilyflow.com/api/track/conversion
GET  https://app.affilyflow.com/api/track/conversion

• Både GET og POST virker. OPTIONS svarer på CORS-forespørgsler.
• CORS er åben (Access-Control-Allow-Origin: *), så endpointet kan kaldes fra enhver browser.
• Der kræves ingen nøgle. Det, der binder salget til en affiliate, er klik-id'et.

Klik-id'et først

Uden klik-id'et kan salget ikke tilskrives nogen. Det kommer fra affiliate-linket som ?afid= på jeres side, og track.js gemmer det i cookien af_click på jeres domæne. Jeres server kan derfor læse cookien fra kundens anmodning, når ordren oprettes, og sende den med.

Har I ikke track.js på siden, så gem selv afid fra adressen. Tag kun værdier, der ligner vores: c_ efterfulgt af 4–64 tegn (bogstaver, tal, _ og -).

Parametre

Ældre direkte links uden klik-id kan i stedet sende aff (eller aff_id) – affiliatens tracking-id – sammen med store. Så skal affiliaten være tilmeldt butikkens program, ellers svares not_joined.

GET

Parametrene i adressen. Det er det, track.js bruger som reserve, når browseren ikke har sendBeacon.

curl "https://app.affilyflow.com/api/track/conversion?afid=c_AbC123xYz_-9&store=DIN_BUTIK&order=1008&total=499&currency=DKK"

POST

Send felterne som JSON i kroppen. Felterne kan også stå i adressen – findes et felt begge steder, vinder kroppen. Det er sådan track.js sender med navigator.sendBeacon: en POST med felterne i adressen og ingen krop.

curl -X POST https://app.affilyflow.com/api/track/conversion \
  -H "Content-Type: application/json" \
  -d '{"afid":"c_AbC123xYz_-9","store":"DIN_BUTIK","order":"1008","total":499,"currency":"DKK"}'

await fetch('https://app.affilyflow.com/api/track/conversion', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    afid: order.afClick,       // gemt fra cookien af_click
    store: 'DIN_BUTIK',
    order: order.number,
    total: order.subtotalExVat, // varer efter rabat, uden moms og fragt
    currency: order.currency
  })
});

Kroppen må højst fylde 64 KB.

Valgfrie felter i kroppen

Opdelingen: Sender I total som ordrens samlede beløb og subtotal med, regnes provisionen af subtotal i stedet – dog aldrig af mere end total:

• Er tax 0 eller mangler, eller er subtotal + shipping + tax = total (moms lagt oven i), er grundlaget subtotal.
• Er subtotal + shipping = total (moms inkluderet i priserne), er grundlaget subtotal × (total − tax) / total.
• Ellers bruges det forsigtige min(subtotal, total − tax − shipping).

Det enkleste er at sende total som varernes beløb uden moms og fragt og udelade opdelingen.

Svar

Svaret er altid JSON med en status. Hvad hver status betyder, og hvad I gør, står i Statuskoder.

Et registreret salg afventer butikkens godkendelse. Provisionen krediteres først, når salget er godkendt.

Dubletter og ordrenumre

• Samme ordrenummer i samme program tælles aldrig to gange – andet kald svarer duplicate. Det er derfor sikkert at sende igen, hvis I er i tvivl.
• Uden ordrenummer er der ingen dubletkontrol på serveren. Send altid ordrenummeret.
• En uudfyldt pladsholder (DIN_ORDRE_ID, ORDER_ID, {{ … }}, [ … ], < … >, % … % m.fl.) behandles som intet ordrenummer, så den aldrig optager nummeret for alle senere salg.

Valuta

Salget kan være i enhver valuta med en kurs fra Den Europæiske Centralbank. Det omregnes til butikkens afregningsvaluta, før provision og gebyr regnes, og kursen låses på salget. En valutakode, der ikke er tre bogstaver, eller en valuta uden en kurs fra de seneste 10 dage, afvises som unsupported_currency.

Grænser

• Endpointet er begrænset pr. IP-adresse. Grænsen rammer ikke en butiks egen server ved normal brug; svaret er 429 med rate_limited, hvis den nås.
• Hvert program har et beløbsloft pr. ordre (standard 50.000 i afregningsvalutaen). En ordre over loftet afvises som value_too_high – typisk et beløb sendt i øre eller cent.
• Lange værdier afkortes i stedet for at blive afvist: klik-id 64 tegn, butik og ordrenummer 120 tegn.

Refusioner

Endpointet melder kun salg. Refunderes en ordre, afviser butikken salget under Salg i dashboardet inden for programmets godkendelsesperiode. /api/track/conversion/reverse bruges af WooCommerce-pluginnet og kræver butikkens nøgle – det er ikke en offentlig vej.

Se også Specialbygget webshop og Test og fejlfinding.