Palvelinpuolen seuranta CCV Shopille
Yhdistä CCV Shop API -avaimesi ja paina Create webhook. CCV ilmoittaa sen jälkeen jokaisen maksetun tilauksen ROASaurus-palveluun, joka lähettää sen mainosalustoillesi palvelimelta.
| CCV Shop pähkinänkuoressa | |
|---|---|
| Tilausten saapuminen | Webhook (order paid) sekä pollaus 5 minuutin välein |
| Webhookin käyttöönotto | Automaattinen, Create webhook -painikkeella |
| Tunnistetiedot | Public key ja secret key kohdasta API gegevens |
| Pyyntöjen allekirjoitus | HMAC-SHA512 jokaisessa API-kutsussa |
| Kiitossivun koodinpätkä | Tilauksen onnistumissivu, käyttäen Vertoshop.getOrder().getId() |
Näin CCV Shop yhdistetään
- Lisää ROASaurus-skripti kaikille sivuille: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML tai sovelluksen koodilohko headerissa.
- Lisää kiitossivun koodinpätkä tilauksen onnistumissivulle.
- Mijn webshop › Instellingen › Algemeen › API gegevens: kopioi public key ja secret key. Jos et näe kohtaa API gegevens, asenna ensin API-sovellus.
- Syötä molemmat avaimet ROASaurus-palveluun, tallenna ja paina sitten Create webhook.
Mitä Create webhook tekee
ROASaurus rekisteröi CCV-webhookin tapahtumalle order paid. CCV ilmoittaa sen jälkeen jokaisen maksetun tilauksen heti. Kun CCV palauttaa webhook secretin, ROASaurus tarkistaa jokaisen toimituksen HMAC-SHA512-allekirjoituksen; jokaisessa toimituksessa on oltava myös kauppasi ainutlaatuinen token. ROASaurus hakee sen jälkeen koko tilauksen ja sen tilausrivit API:sta.
Jokainen ROASaurus-palvelun tekemä API-kutsu allekirjoitetaan CCV:n vaatimalla tavalla: public keysi, metodin, osoitteen, bodyn ja aikaleiman HMAC-SHA512-hashilla.
5 minuutin tarkistus
ROASaurus kysyy CCV:ltä maksetut tilaukset myös 5 minuutin välein. CCV suodattaa vain luontipäivän mukaan, joten tilaus, joka merkitään maksetuksi päiviä sen tekemisen jälkeen, tulee webhookin eikä tarkistuksen kautta.
Mitä ROASaurus lukee jokaisesta tilauksesta
Täydellinen tilausnumero, kokonaissumma, valuutta, asiakkaan sähköposti, matkapuhelin- tai puhelinnumero, nimi, laskutuskaupunki, postinumero ja maa, asiakastunnus sekä jokainen tilausrivi tuotenumeroineen, määrineen ja hintoineen.
Rajoitukset
- CCV-tilaukset eivät sisällä ostajan IP-osoitetta, joten IP-varavaihtoehto ei ole käytettävissä. Lisää kiitossivun koodinpätkä.
- Pidä webhook aktiivisena: myöhemmät maksut perustuvat siihen.
- Liitin on rakennettu alustan virallisen API-dokumentaation pohjalta. Paina Test connection tunnistetietojen tallentamisen jälkeen, tee sitten testitilaus ja tarkista Event log.
Aiheeseen liittyvää
Vastauksia kysymyksiin
Mistä löydän CCV Shop API -avaimeni?
Kohdasta Mijn webshop › Instellingen › Algemeen › API gegevens. Jos tämä valikko puuttuu, asenna ensin CCV:n API-sovellus.
Mitä tilauksen onnistumissivun koodinpätkä tekee?
Se lukee tilaus-ID:n komennolla Vertoshop.getOrder().getId() ja laukaisee sillä ROASaurus-oston, mikä yhdistää tilauksen kävijään ja tämän mainosklikkaukseen.
Lähetetäänkö myöhemmin maksetut tilaukset silti?
Kyllä, order-paid-webhookin kautta. 5 minuutin tarkistus katsoo vain äskettäin luotuja tilauksia, joten pidä webhook aktiivisena.
Jokainen myynti jäljitetty mainokseen, joka sen ansaitsi
Palvelinpuolen seuranta, voitto ja asiakkuuden elinkaariarvo yhdessä sovelluksessa. 14 päivän ilmainen kokeilu, ei luottokorttia.
Aloita ilmainen kokeilu →