Webáruház-integráció

Szerveroldali követés Ecwid-webáruházakhoz

A ROASaurus egy custom app tokenen keresztül olvassa a kifizetett Ecwid-rendeléseket, és a szerverről elküldi a hirdetési platformjaidnak. Kérj az Ecwid ügyfélszolgálatától webhookokat, és a rendelések azonnal megérkeznek.

Az Ecwid dióhéjban
A rendelések így érkeznekAPI-lekérdezés 5 percenként; webhookok, ha az Ecwid ügyfélszolgálata bekapcsolta őket
Hozzáférési adatokStore ID, a custom app secret tokenje és a webhookokhoz tartozó client secret
Webhook-ellenőrzésHMAC-aláírás a client secrettel
Kifizetett rendelésekA fizetési státusz PAID
Köszönőoldali kódrészletEcwid.OnOrderPlaced, a követőscript után

Hogyan csatlakozik az Ecwid

  1. Add hozzá a ROASaurus scriptet ahhoz az oldalhoz, amelyik beágyazza az Ecwid webáruházadat, vagy az Instant Site egyedi kódjához.
  2. Add hozzá utána a köszönőoldali kódrészletet. Az az Ecwid OnOrderPlaced eseményére figyel, és a rendelésszámmal, a végösszeggel és az e-mail-címmel küldi el a ROASaurus vásárlást.
  3. A my.ecwid.com/#develop-apps oldalon hozz létre egy custom appot a rendelések olvasási jogosultságával. Add meg a ROASaurusban a store ID-dat (az admin URL-ben és az Account › Summary alatt látható) és az app secret_… tokenjét.

A ROASaurus ezután 5 percenként lekéri a legutóbbi futása óta frissült rendeléseket, és a PAID fizetési státuszúakat elküldi.

Azonnali rendelések webhookokkal

Az Ecwid a custom appok webhook-URL-jeit az API-támogatási csapatán keresztül állítja be. Kérd meg őket, hogy az appod webhook-URL-jét állítsák a ROASaurus Connection fülén lévőre, az order.created és order.updated eseményekkel. Illeszd be az app client secretjét a ROASaurusban: minden webhookot ellenőrzünk a HMAC-aláírása alapján, és a rendelést ezután az API-ból kérjük le.

Mit olvas ki a ROASaurus az egyes rendelésekből

A végösszeg, a pénznem, az e-mail-cím, a számlázási név, telefonszám és cím, az ügyfélazonosító és a tételek kombinációval, mennyiséggel, árral és SKU-val. Az Ecwid-rendelések a vásárló IP-címét és user agentjét is tartalmazzák, így a ROASaurus ugyanazon IP-cím és böngésző alapján is tud egyeztetni, de csak akkor, ha pontosan egy látogató jön szóba.

Korlátok

  • A webhookokhoz kérést kell küldeni az Ecwid ügyfélszolgálatának. Addig a rendelések legfeljebb 5 perccel később érkeznek.
  • Az Ecwid egyetlen névmezőt ad, amelyet a ROASaurus vezeték- és keresztnévre bont.
  • 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ó

GYIK

Kérdések, válaszok

Miért kell az Ecwid ügyfélszolgálatához fordulnom a webhookokért?

Az Ecwid a custom appok webhook-URL-jét az API-támogatásán keresztül állítja be. Az 5 percenkénti lekérdezés nélkülük is működik.

Mire való a client secret?

Ezzel igazolja, hogy a webhook valóban az Ecwidtől jön. A ROASaurus a rendelés lekérése előtt ezzel ellenőrzi minden webhook HMAC-aláírását.

Működik, ha az Ecwid egy másik oldalba van beágyazva?

Igen. Add hozzá a ROASaurus scriptet és a köszönőoldali kódrészletet ahhoz az oldalhoz, amelyik beágyazza az Ecwid webáruházadat.

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 →