Lähetä tilaukset Zapieriin, Make-palveluun ja muihin sovelluksiin webhookien avulla

Webhook lähettää kauppasi tapahtumat toiseen sovellukseen heti, kun ne tapahtuvat. Lisää sellainen, niin jokainen maksettu tilaus voi päätyä Zapieriin tai Make-palveluun ja sieltä edelleen Google Sheetsiin, Slackiin, sähköpostilistallesi, kirjanpitosovellukseesi ja tuhansiin muihin. Koodia ei tarvita.

Lisää webhook

1. Napsauta sivustosi hallintapaneelissa Integraatiot.
2. Ota kohdassa Automaatio käyttöön Webhookit. Ponnahdusikkuna avautuu.

   

3. Valitse tapahtuma kohdasta Tapahtuma, liitä sovelluksesi antama osoite kenttään Webhookin osoite ja napsauta painiketta Lisää webhook.
4. Lähetä esimerkkitilaus napsauttamalla Lähetä testi ja napsauta sitten Valmis.

   

Webhookit alkavat toimia heti, kun lisäät ne. Julkaisua ei tarvita.

Yhdistä Zapier-palveluun

1. Luo Zap Zapierissa. Valitse triggeriksi Webhooks by Zapier ja sitten Catch Hook.
2. Kopioi webhookin URL-osoite, jonka Zapier näyttää.
3. Lisää Paylyssa webhook tapahtumalle Tilaus maksettu ja liitä tuo URL-osoite.
4. Napsauta Lähetä testi. Napsauta Zapierissa takaisin palattuasi Test trigger. Näet esimerkkitilauksen, #9999, asiakkaana John Smith.
5. Lisää haluamasi toiminto, esimerkiksi uusi rivi Google Sheetsiin, ja yhdistä kentät: Order Number, Order Total, Order Customer Email ja niin edelleen.
6. Julkaise Zap. Jokainen maksettu tilaus käynnistää sen nyt.

Webhooks by Zapier on yksi Zapierin premium-sovelluksista, joten se vaatii maksullisen Zapier-paketin.

Yhdistä Make-palveluun

1. Luo Make-palvelussa skenaario. Lisää Webhooks, sitten Custom webhook, ja luo uusi webhook napsauttamalla Add.
2. Kopioi osoite, jonka Make näyttää.
3. Lisää Paylyssa webhook tällä osoitteella ja napsauta Lähetä testi. Make lukee esimerkin ja oppii kentät.
4. Lisää haluamasi moduulit, yhdistä kentät ja ota skenaario käyttöön.

Tapahtumat

• Tilaus maksettu: tilaus maksetaan. Tähän kuuluvat toistuvan tilauksen ensimmäinen maksu, jokainen uusiutuminen ja tilaus, jonka lisäät käsin maksettuna.
• Tilaus lähetetty: merkitset tilauksen lähetetyksi. Kun toimitat tilauksen osissa, jokaisesta toimituksesta lähetetään tapahtuma.
• Tilaus hyvitetty: rahaa palautetaan, oli hyvitys tehty Paylyssa, Stripessä tai PayPalissa. Myös jokainen osittainen hyvitys lähetetään.
• Toistuva tilaus alkoi: toistuvan tilauksen ensimmäinen tilaus.
• Toistuva tilaus uusiutui: jokainen ensimmäisen jälkeinen maksu.
• Toistuva tilaus päättyi: toistuva tilaus perutaan tai se umpeutuu, päättymispäivänä.

Mitä Payly lähettää

Jokainen tapahtuma lähetetään JSON-muodossa. Jokainen tilaustapahtuma sisältää:

• Tilausnumero, esimerkiksi #1000, sen tila ja maksuajankohta
• Välisumma, alennus ja alennuskoodi, toimitus, vero, yhteensä ja hyvitetty summa sekä valuutta
• Jokaisen tuotteen nimi, tuotekoodi, määrä, hinta ja rivin summa
• Asiakkaan nimi, sähköposti ja puhelinnumero sekä toimitusosoite
• Maksutapa, esimerkiksi Stripe tai PayPal
• test_mode, joka on tosi, kun tilaus on tehty testitilassa

Toimitukset lisäävät kuljetusyhtiön ja seurantanumeron. Hyvitykset lisäävät tähän mennessä hyvitetyn kokonaissumman. Toistuvan tilauksen tapahtumat lisäävät paketin, sen hinnan, laskutustiheyden ja seuraavan uusiutumispäivän. Esimerkissä, jonka Lähetä testi lähettää, on "test": true. Korttinumerot jäävät Stripelle ja PayPalille, joten ne eivät koskaan päädy webhookiin.

Jos webhook epäonnistuu

Sovelluksella on 5 sekuntia aikaa vastata. Jos se ei vastaa tai vastaa virheilmoituksella, Payly yrittää uudelleen enintään 7 kertaa lisää noin neljän ja puolen tunnin aikana. Ponnahdusikkunassa näkyvät kunkin webhookin viimeisimmät lähetykset, joten näet, mitä tapahtui.

Jos kolme peräkkäistä tapahtumaa epäonnistuu kaikilla yrityskerroilla, webhook keskeytetään, ja Integraatiot-näkymässä näkyy siitä ilmoitus. Tarkista osoite ja napsauta sitten painiketta Ota takaisin käyttöön.

Tarkista, että webhook tuli kaupastasi

Zapier ja Make eivät tarvitse tätä. Jos rakennat oman sovelluksen, jokaisessa pyynnössä on X-Payly-Hmac-Sha256-otsikko: pyynnön sisältö allekirjoitettuna HMAC-SHA256-menetelmällä kaupan allekirjoitusavaimella, base64-muodossa. Avain löytyy Webhookit-ponnahdusikkunasta. Laske sama allekirjoitus raakasisällöstä ja vertaa näitä kahta.

Otsikko X-Payly-Webhook-Id pysyy samana, kun lähetystä yritetään uudelleen, joten sovelluksesi voi ohittaa jo käsitellyn.