Leads og abonnementer

Betaler jeres program pr. lead, eller sælger I abonnementer, kan jeres egen server melde det hele til Affilyflow med butikkens API med nøgle: leads, salget der kommer efter et lead, og hver betaling af et abonnement. Reglerne er de samme som for alle andre salg – cookie-periode, blokerede affiliates, programregler, selvhenvisning og salg til vurdering.

Alle kald kræver butikkens API-nøgle i Authorization: Bearer afs_…. Opret den under Indstillinger → API-nøgler, og læg den i en miljøvariabel, fx AFFILYFLOW_API_KEY. Send gerne Idempotency-Key med hvert POST, så et kald kan prøves igen efter en timeout uden at tælle to gange – se Idempotens.

POST https://app.affilyflow.com/api/v1/store/leads
GET  https://app.affilyflow.com/api/v1/store/leads/{lead_id}
POST https://app.affilyflow.com/api/v1/store/leads/{lead_id}/reject
POST https://app.affilyflow.com/api/v1/store/leads/{lead_id}/qualify
POST https://app.affilyflow.com/api/v1/store/conversions

Hvem melder hvad?

Leads fra jeres server

Et lead fra serveren virker på tværs af enheder og kan kvalificeres eller afvises bagefter. Det er kun for lead-programmer – i et program, der betaler pr. salg, svares 422 not_lead_program.

curl -X POST https://app.affilyflow.com/api/v1/store/leads \
  -H "Authorization: Bearer $AFFILYFLOW_API_KEY" \
  -H "Idempotency-Key: LEAD-2026-0042" \
  -H "Content-Type: application/json" \
  -d '{"lead_id":"LEAD-2026-0042","afid":"c_AbC123xYz_-9","occurred_at":"2026-11-13T09:30:00Z"}'

• Et lead pr. lead_id. Samme lead_id igen giver 200 duplicate og tæller ikke to gange.
• Højst et lead pr. klik. Et lead mere på samme klik giver 422 lead_per_click. Kan samme besøgende blive flere leads (fx flere bookinger), så slå Flere leads pr. klik til under Program → Vilkår → Leads og salg. Et afvist lead tæller ikke med.
• Programmets vilkår gælder. Leadet får programmets faste beløb pr. lead og dets godkendelsesperiode og følger samme regler som et salg.

Svaret er 201 med status: "ok" og leadet, som GET viser det (id, status, test, created_at, approval_due_at, commission, network_fee, attribution, confirmed_by_server, kind, lead_id, lead_qualified_at, awaiting_qualification m.fl.). Et lead, der gav 422, er ikke registreret – koderne står i Statuskoder.

Slå et lead op

curl https://app.affilyflow.com/api/v1/store/leads/LEAD-2026-0042 \
  -H "Authorization: Bearer $AFFILYFLOW_API_KEY"

Et ukendt lead_id giver 404 not_found. Slå et testlead op med ?test=true.

Afvis et ugyldigt lead

curl -X POST https://app.affilyflow.com/api/v1/store/leads/LEAD-2026-0042/reject \
  -H "Authorization: Bearer $AFFILYFLOW_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"code":"duplicate","reason":"Samme kunde har allerede bestilt et tilbud"}'

• code er en af duplicate, test_order, other_source, invalid_traffic, not_delivered eller other (standard). other kræver en reason på mindst 3 tegn. reason er højst 300 tegn, og affiliaten ser den.
• Kun et afventende lead inden for godkendelsesperioden kan afvises – eller et lead, der er markeret til vurdering. Affiliaten får besked.
• Svaret er 200 med status: "rejected" (eller already_rejected) og leadet. Et godkendt lead giver 409 already_reviewed, et lead, Affilyflow er ved at vurdere, 422 held_by_affilyflow, og et lead efter godkendelsesperioden 422 reject_window.

Leads, der skal kvalificeres

Slår I Leads skal kvalificeres til under Program → Vilkår → Leads og salg, venter hvert nyt lead, til I har kvalificeret det – det godkendes aldrig automatisk før. Kvalificer det med API'et eller med Godkend under Salg i dashboardet.

curl -X POST https://app.affilyflow.com/api/v1/store/leads/LEAD-2026-0042/qualify \
  -H "Authorization: Bearer $AFFILYFLOW_API_KEY"

Svaret er 200 med status: "qualified" (eller already_qualified) og leadet. Et afvist lead giver 409 already_rejected. Et kvalificeret lead følger derefter godkendelsesperioden som alle andre.

Leads fra hjemmesiden

Sporingskoden kan også melde et lead uden kode, når kunden når jeres tak-side (data-lead-url, se Lead uden kode). Den melder højst et lead pr. besøg, og samme regel om et lead pr. klik gælder.

Lead og salg

Vælg under Program → Vilkår → Leads og salg, hvad et lead-program betaler for:

• Salget kobles til leadet via samme klik – uanset om salget meldes af sporingskoden, et plugin, Stripe eller jeres server – eller via lead_id på POST /conversions.
• Salgsprovisionen låses på klikket som programmets sats.
• Et salg efter et lead måles fra leadet: kommer salget inden for cookie-perioden efter leadet, giver det provision.

curl -X POST https://app.affilyflow.com/api/v1/store/conversions \
  -H "Authorization: Bearer $AFFILYFLOW_API_KEY" \
  -H "Idempotency-Key: 1042" \
  -H "Content-Type: application/json" \
  -d '{"order":"1042","total":2400,"currency":"DKK","lead_id":"LEAD-2026-0042"}'

Med lead_id behøver I ikke sende klikket igen. Findes leadet ikke, svares 422 lead_not_found (et testlead findes kun med "test": true), er det afvist 422 lead_rejected, og betaler programmet kun pr. lead 422 lead_only_program.

Abonnementer fra jeres server

Sælger I abonnementer uden for Stripe, melder jeres server hver betaling til POST /conversions. Antallet af måneder, der giver provision, vælger I under Recurring provision (abonnementer) på Program (6, 12 eller 24 måneder eller livstid), og det låses på klikket.

Første betaling er et almindeligt salg med klikket (eller kundens rabatkoder) og abonnementets id:

curl -X POST https://app.affilyflow.com/api/v1/store/conversions \
  -H "Authorization: Bearer $AFFILYFLOW_API_KEY" \
  -H "Idempotency-Key: INV-5001" \
  -H "Content-Type: application/json" \
  -d '{"order":"INV-5001","total":199,"currency":"DKK","afid":"c_AbC123xYz_-9","subscription_id":"SUB-881","period":"2026-11"}'

Hver fornyelse sendes med "renewal": true og samme subscription_id – uden klik:

curl -X POST https://app.affilyflow.com/api/v1/store/conversions \
  -H "Authorization: Bearer $AFFILYFLOW_API_KEY" \
  -H "Idempotency-Key: INV-5114" \
  -H "Content-Type: application/json" \
  -d '{"order":"INV-5114","total":199,"currency":"DKK","subscription_id":"SUB-881","renewal":true,"period":"2026-12"}'

• Reglerne er de samme som for Stripe: antallet af måneder er låst på klikket, et abonnement giver provision til loftet er nået, og er første betaling afvist, giver fornyelserne heller ingen provision.
• Provisionen regnes af total – varerne efter rabat, uden moms og fragt – som ved et salg.
• Hver fornyelse er sit eget salg med sit eget ordrenummer. Den refunderes for sig med refusions-endpointet.
• Svaret på en registreret fornyelse er 201 ok med cycle (hvilken betaling det er) og cap (loftet fra klikket).
• Med "test": true virker det hele som testsalg, også fornyelserne.

Kodestumper

Kodestumperne under Specialbygget webshop i Opsætning og i Sporing fra jeres server har funktionerne færdige: i PHP affilyflow_lead(…) og affilyflow_sale(…) med de navngivne argumenter subscriptionId:, renewal:, period: og leadId:, og i JavaScript/TypeScript affilyflowLead({ leadId, click, coupons, email, value, currency, occurredAt }) og affilyflowSale({ …, subscriptionId, renewal, period, leadId }).

Se også Konverterings-API, Statuskoder og Godkendelse og refusioner.