Szerveroldali követés CCV Shophoz
Csatlakoztasd a CCV Shop API-kulcsaidat, és nyomd meg a Create webhook gombot. A CCV ezután minden kifizetett rendelést jelent a ROASaurusnak, amely a szerverről elküldi a hirdetési platformjaidnak.
| A CCV Shop dióhéjban | |
|---|---|
| A rendelések így érkeznek | Webhook (order paid) plusz lekérdezés 5 percenként |
| Webhook beállítása | Automatikus, a Create webhook gombbal |
| Hozzáférési adatok | Public key és secret key az API gegevens oldalról |
| Kérés aláírása | HMAC-SHA512 minden API-hívásnál |
| Köszönőoldali kódrészlet | A rendelés sikeroldala, a Vertoshop.getOrder().getId() használatával |
Hogyan csatlakozik a CCV Shop
- Add hozzá a ROASaurus scriptet az összes oldalhoz: Mijn webshop › Instellingen › Lay-out › Layout › Header HTML, vagy egy app kódblokkja a fejlécben.
- Add hozzá a köszönőoldali kódrészletet a rendelés sikeroldalához.
- Mijn webshop › Instellingen › Algemeen › API gegevens: másold ki a public key-t és a secret key-t. Ha nem látod az API gegevens menüpontot, előbb telepítsd az API appot.
- Add meg mindkét kulcsot a ROASaurusban, mentsd, majd nyomd meg a Create webhook gombot.
Mit csinál a Create webhook
A ROASaurus regisztrál egy CCV-webhookot az order paid eseményre. A CCV ezután azonnal jelent minden kifizetett rendelést. Ha a CCV ad vissza webhook secretet, a ROASaurus minden kézbesítés HMAC-SHA512 aláírását ellenőrzi; minden kézbesítésnek a webáruházadra egyedi tokent is hordoznia kell. A ROASaurus ezután lekéri az API-ból a teljes rendelést és a rendelés sorait.
A ROASaurus minden API-hívását úgy írja alá, ahogy a CCV megköveteli: a public key-d, a metódus, a cím, a törzs és egy időbélyeg HMAC-SHA512 hash-ével.
Az 5 perces ellenőrzés
A ROASaurus 5 percenként a CCV-től is lekéri a kifizetett rendeléseket. A CCV csak létrehozási dátumra szűr, ezért azt a rendelést, amelyet a leadása után napokkal jelölnek kifizetettnek, a webhook veszi fel, nem az ellenőrzés.
Mit olvas ki a ROASaurus az egyes rendelésekből
A teljes rendelésszám, a végösszeg, a pénznem, a vevő e-mail-címe, mobil- vagy vezetékes telefonszáma, a neve, a számlázási város, irányítószám és ország, az ügyfélazonosító, valamint minden rendelési sor cikkszámmal, mennyiséggel és árral.
Korlátok
- A CCV-rendelések nem tartalmazzák a vásárló IP-címét, ezért az IP-alapú tartalék nem érhető el. Add hozzá a köszönőoldali kódrészletet.
- Tartsd aktívan a webhookot: a késői fizetések erre támaszkodnak.
- A csatlakozó a platform hivatalos API-dokumentációja alapján készült. A hitelesítő adatok mentése után nyomd meg a Test connection gombot, majd adj le egy tesztrendelést, és nézd meg az Event logot.
Kapcsolódó
Kérdések, válaszok
Hol találom a CCV Shop API-kulcsaimat?
A Mijn webshop › Instellingen › Algemeen › API gegevens alatt. Ha ez a menü hiányzik, előbb telepítsd a CCV API appját.
Mit csinál a rendelés sikeroldali kódrészlete?
A Vertoshop.getOrder().getId() hívással kiolvassa a rendelésazonosítót, és azzal küldi el a ROASaurus vásárlást, ami összeköti a rendelést a látogatóval és a hirdetési kattintásával.
A később kifizetett rendeléseket is elküldi?
Igen, az order-paid webhookon keresztül. Az 5 perces ellenőrzés csak a nemrég létrehozott rendeléseket nézi, ezért tartsd aktívan a webhookot.
Minden eladás visszavezetve arra a hirdetésre, amelyik hozta
Szerveroldali követés, profit és ügyfél-élettartamérték egyetlen appban. 14 napos ingyenes próbaidőszak, bankkártya nélkül.
Indítsd el az ingyenes próbaidőszakot →