Integracija s web-trgovinom

Praćenje na strani poslužitelja za CCV Shop

Povežite svoje CCV Shop API ključeve i pritisnite Create webhook. CCV tada svaku plaćenu narudžbu prijavljuje u ROASaurus, a ROASaurus je s poslužitelja šalje na vaše oglasne platforme.

CCV Shop ukratko
Narudžbe stižu putemWebhook (narudžba plaćena) uz dohvaćanje svakih 5 minuta
Postavljanje webhookaAutomatski, gumbom Create webhook
Pristupni podaciJavni ključ i tajni ključ iz API gegevens
Potpisivanje zahtjevaHMAC-SHA512 na svakom API pozivu
Isječak za stranicu zahvaleStranica uspješne narudžbe, uz Vertoshop.getOrder().getId()

Kako se povezuje CCV Shop

  1. Dodajte ROASaurus skriptu na sve stranice: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML ili blok koda aplikacije u zaglavlju.
  2. Dodajte isječak za stranicu zahvale na stranicu uspješne narudžbe.
  3. Mijn webshop › Instellingen › Algemeen › API gegevens: kopirajte javni ključ i tajni ključ. Ako ne vidite API gegevens, prvo instalirajte API aplikaciju.
  4. Oba ključa unesite u ROASaurus, spremite, a zatim pritisnite Create webhook.

Što radi Create webhook

ROASaurus registrira CCV webhook za događaj order paid. CCV tada svaku plaćenu narudžbu javlja odmah. Kada CCV vrati tajni ključ webhooka, ROASaurus provjerava HMAC-SHA512 potpis svake isporuke; svaka isporuka mora nositi i token jedinstven za vašu web-trgovinu. ROASaurus zatim iz API-ja dohvaća cijelu narudžbu i njezine retke.

Svaki API poziv koji ROASaurus uputi potpisan je onako kako CCV zahtijeva: HMAC-SHA512 hash vašeg javnog ključa, metode, adrese, tijela zahtjeva i vremenske oznake.

Provjera svakih 5 minuta

ROASaurus svakih 5 minuta i sam traži od CCV-a plaćene narudžbe. CCV filtrira samo prema datumu stvaranja, pa narudžbu koja se označi plaćenom danima nakon zaprimanja hvata webhook, a ne provjera.

Što ROASaurus čita iz svake narudžbe

Puni broj narudžbe, ukupni iznos, valutu, e-adresu kupca, broj mobitela ili telefona, ime, grad, poštanski broj i državu za naplatu, ID kupca te svaki redak narudžbe s brojem proizvoda, količinom i cijenom.

Ograničenja

  • CCV narudžbe ne sadrže IP adresu kupca pa rezervna opcija s IP adresom nije dostupna. Dodajte isječak za stranicu zahvale.
  • Neka webhook ostane aktivan: kasna plaćanja ovise o njemu.
  • Konektor je izrađen prema službenoj API dokumentaciji platforme. Nakon spremanja vjerodajnica pritisnite Test connection, zatim zadajte probnu narudžbu i provjerite Event log.

Povezano

Česta pitanja

Pitanja i odgovori

Gdje mogu pronaći svoje CCV Shop API ključeve?

U Mijn webshop › Instellingen › Algemeen › API gegevens. Ako tog izbornika nema, prvo instalirajte CCV-ovu API aplikaciju.

Što radi isječak stranice uspješne narudžbe?

Čita ID narudžbe pomoću Vertoshop.getOrder().getId() i s njim pokreće ROASaurus kupnju, čime se narudžba povezuje s posjetiteljem i njegovim klikom na oglas.

Šalju li se i narudžbe plaćene kasnije?

Da, putem webhooka za plaćenu narudžbu. Provjera svakih 5 minuta gleda samo nedavno stvorene narudžbe, zato neka webhook ostane aktivan.

Svaka prodaja, praćena do oglasa koji ju je zaradio

Praćenje na strani poslužitelja, dobit i životna vrijednost kupca u jednoj aplikaciji. 14-dnevno besplatno probno razdoblje, bez kreditne kartice.

Započnite besplatno probno razdoblje →