Webbshopintegration

Server-side tracking för CCV Shop

Anslut dina CCV Shop API-nycklar och klicka på Create webhook. CCV rapporterar sedan varje betald order till ROASaurus, som skickar den till dina annonsplattformar från servern.

CCV Shop i korthet
Ordrar kommer in viaWebhook (order paid) plus polling var 5:e minut
Webhook-installationAutomatiskt, med knappen Create webhook
ÅtkomstuppgifterPublic key och secret key från API gegevens
Signering av förfrågningarHMAC-SHA512 på varje API-anrop
Tacksides-snippetOrderbekräftelsesida, med Vertoshop.getOrder().getId()

Så ansluter CCV Shop

  1. Lägg till ROASaurus-skriptet på alla sidor: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML, eller ett kodblock från en app i headern.
  2. Lägg till tacksides-snippetet på orderbekräftelsesidan.
  3. Mijn webshop › Instellingen › Algemeen › API gegevens: kopiera public key och secret key. Om du inte ser API gegevens installerar du API-appen först.
  4. Ange båda nycklarna i ROASaurus, spara och klicka sedan på Create webhook.

Vad Create webhook gör

ROASaurus registrerar en CCV-webhook för händelsen order paid. CCV rapporterar sedan varje betald order direkt. När CCV returnerar en webhook secret kontrollerar ROASaurus HMAC-SHA512-signaturen för varje leverans; varje leverans måste också bära den token som är unik för din butik. ROASaurus hämtar sedan hela ordern och dess orderrader från API:et.

Varje API-anrop som ROASaurus gör signeras på det sätt som CCV kräver: en HMAC-SHA512-hash av din public key, metoden, adressen, body och en tidsstämpel.

5-minuterskontrollen

ROASaurus frågar också CCV efter betalda ordrar var 5:e minut. CCV filtrerar bara på skapandedatum, så en order som markeras som betald flera dagar efter att den lagts fångas upp av webhooken, inte av kontrollen.

Vad ROASaurus läser från varje order

Hela ordernumret, totalsumman, valutan, kundens e-postadress, mobil- eller telefonnummer, namn, faktureringsort, postnummer och land, kund-id:t och varje orderrad med produktnummer, antal och pris.

Begränsningar

  • CCV-ordrar innehåller inte köparens IP-adress, så IP-reserven är inte tillgänglig. Lägg till tacksides-snippetet.
  • Låt webhooken vara aktiv: sena betalningar är beroende av den.
  • Kopplingen är byggd utifrån plattformens officiella API-dokumentation. Klicka på Test connection när du har sparat dina åtkomstuppgifter, lägg sedan en testorder och kolla i Event log.

Relaterat

Vanliga frågor

Frågor, besvarade

Var hittar jag mina CCV Shop API-nycklar?

I Mijn webshop › Instellingen › Algemeen › API gegevens. Om den menyn saknas installerar du CCVs API-app först.

Vad gör snippetet på orderbekräftelsesidan?

Det läser order-id:t med Vertoshop.getOrder().getId() och skickar ROASaurus-köpet med det, vilket kopplar ordern till besökaren och dennes annonsklick.

Skickas ordrar som betalas senare ändå?

Ja, via webhooken för betald order. 5-minuterskontrollen tittar bara på nyligen skapade ordrar, så låt webhooken vara aktiv.

Varje försäljning, spårad till annonsen som genererade den

Server-side tracking, vinst och livstidsvärde i en app. 14 dagars gratis provperiod, inget kreditkort.

Starta din gratis provperiod →