Rendelések küldése a Zapier, a Make és más alkalmazások felé webhookokkal

A webhook elküldi webáruháza eseményeit egy másik alkalmazásnak, amint azok megtörténnek. Adjon hozzá egyet, és minden kifizetett rendelés eljuthat a Zapier vagy a Make felé, onnan pedig tovább például a Google Sheets, a Slack, a levelezőlistája, a könyvelőprogramja és még több ezer más szolgáltatás felé. Nincs szükség programozásra.

Webhook hozzáadása

1. A webhelye vezérlőpultján kattintson az Integrációk menüpontra.
2. Az Automatizálás részben kapcsolja be a Webhookok lehetőséget. Felugró ablak nyílik meg.

   

3. Az Esemény mezőben válasszon egy eseményt, a Webhook címe mezőbe illessze be az alkalmazásától kapott címet, majd kattintson a Webhook hozzáadása gombra.
4. Kattintson a Teszt küldése gombra egy mintarendelés elküldéséhez, majd a Kész gombra.

   

A webhookok azonnal működni kezdenek, amint hozzáadja őket. Nem kell közzétennie.

Kapcsolódás a Zapier szolgáltatáshoz

1. A Zapier felületén hozzon létre egy Zap-et. Eseményindítónak válassza a Webhooks by Zapier, majd a Catch Hook lehetőséget.
2. Másolja ki a webhook URL-jét, amelyet a Zapier megmutat.
3. A Payly-ban adjon hozzá egy webhookot a Rendelés kifizetve eseményhez, és illessze be ezt az URL-t.
4. Kattintson a Teszt küldése gombra. A Zapier felületén térjen vissza, és kattintson a Test trigger gombra. Látni fogja a mintarendelést: #9999, John Smith nevére.
5. Adja hozzá a kívánt műveletet, például egy új sor felvételét a Google Sheets táblázatába, és rendelje hozzá a mezőket: Order Number, Order Total, Order Customer Email és így tovább.
6. Tegye közzé a Zap-et. Ezután minden kifizetett rendelés elindítja.

A Webhooks by Zapier a Zapier prémium alkalmazásai közé tartozik, ezért fizetős Zapier-csomag szükséges hozzá.

Kapcsolódás a Make szolgáltatáshoz

1. A Make felületén hozzon létre egy forgatókönyvet. Adja hozzá a Webhooks, majd a Custom webhook elemet, és kattintson az Add gombra egy új webhook létrehozásához.
2. Másolja ki a címet, amelyet a Make megmutat.
3. A Payly-ban adjon hozzá egy webhookot ezzel a címmel, és kattintson a Teszt küldése gombra. A Make beolvassa a mintát, és megtanulja a mezőket.
4. Adja hozzá a kívánt modulokat, rendelje hozzá a mezőket, és kapcsolja be a forgatókönyvet.

Események

• Rendelés kifizetve: egy rendelés kifizetésre kerül. Ide tartozik az előfizetés első fizetése, minden megújítás, valamint az Ön által kézzel, kifizetettként felvett rendelés.
• Rendelés feladva: Ön feladottként jelöl meg egy rendelést. Ha egy rendelést részletekben ad fel, az egyes szállításokat külön-külön elküldi a rendszer.
• Rendelés visszatérítve: a pénz visszakerül a vevőhöz, függetlenül attól, hogy a visszatérítést a Payly-ban vagy a Stripe, illetve a PayPal felületén indítja el. Az egyes részleges visszatérítések is elküldésre kerülnek.
• Előfizetés elindult: egy előfizetés első rendelése.
• Előfizetés megújult: az első utáni minden egyes fizetés.
• Előfizetés véget ért: az előfizetést lemondják, vagy lejár, a megszűnésének napján.

Mit küld a Payly

Minden esemény JSON formátumban kerül elküldésre. Minden rendeléshez kapcsolódó esemény tartalmazza:

• A rendelésszámot (például #1000), az állapotát és a kifizetés időpontját
• A részösszeget, a kedvezményt és a kedvezménykódot, a szállítást, az adót, a végösszeget és a visszatérített összeget, a pénznemmel együtt
• Minden tétel nevét, cikkszámát, mennyiségét, árát és sorösszegét
• A vevő nevét, e-mail-címét és telefonszámát, valamint a szállítási címet
• A fizetés módját, például Stripe vagy PayPal
• test_mode, amely igaz a tesztmódban leadott rendelésnél

A szállítások a futárszolgálatot és a követési számot is hozzáadják. A visszatérítések az eddig visszatérített teljes összeget adják hozzá. Az előfizetési események az előfizetés csomagját, annak árát, a számlázás gyakoriságát és a következő megújítás dátumát tartalmazzák. A Teszt küldése gombbal küldött minta tartalmazza a "test": true értéket. A kártyaszámok a Stripe és a PayPal rendszerében maradnak, ezért soha nincsenek egy webhookban.

Ha egy webhook meghiúsul

Az alkalmazásnak 5 másodperce van válaszolni. Ha nem válaszol, vagy hibával válaszol, a Payly még legfeljebb 7 alkalommal újrapróbálkozik, nagyjából négy és fél óra alatt. A Webhookok felugró ablak felsorolja az egyes webhookok legutóbbi kézbesítéseit, így láthatja, mi történt.

Ha három egymást követő esemény minden próbálkozásnál meghiúsul, a webhook szünetelni kezd, és az Integrációk képernyő ezt jelzi. Ellenőrizze a címet, majd kattintson a Visszakapcsolás gombra.

Annak ellenőrzése, hogy a webhook az Ön webáruházából érkezett

A Zapier és a Make esetében erre nincs szükség. Ha saját alkalmazást épít, minden kérés tartalmaz egy X-Payly-Hmac-Sha256 fejlécet: a kérés törzse HMAC-SHA256 algoritmussal aláírva, a webáruháza aláírási kulcsával, base64 formátumban. A kulcs a Webhookok felugró ablakban található. Számítsa ki ugyanazt az aláírást a nyers törzsből, és hasonlítsa össze a kettőt.

Az X-Payly-Webhook-Id fejléc ugyanaz marad, amikor egy kézbesítést újrapróbálnak, így az alkalmazása kihagyhatja azt, amelyet már feldolgozott.