Send ordrer til Zapier, Make og andre apps med webhooks

En webhook sender din butiks hændelser videre til en anden app, mens de sker. Tilføj en, så kan hver betalt ordre nå frem til Zapier eller Make og derfra videre til Google Sheets, Slack, din e-mailliste, dit regnskabsprogram og tusindvis af andre. Du behøver ingen kode.

Tilføj en webhook

1. Klik på Integrationer i dashboardet for din hjemmeside.
2. Under Automatisering slår du Webhooks til. Et vindue åbnes.

   

3. Vælg en Hændelse, indsæt den adresse, din app gav dig, i Webhook-adresse, og klik på Tilføj webhook.
4. Klik på Send test for at sende en prøveordre, og klik derefter på Færdig.

   

Webhooks begynder at virke, så snart du tilføjer dem. Du behøver ikke udgive.

Forbind med Zapier

1. Opret en Zap i Zapier. Vælg Webhooks by Zapier som trigger og derefter Catch Hook.
2. Kopiér den webhook-URL, som Zapier viser dig.
3. Tilføj en webhook for Ordre betalt i Payly, og indsæt den URL.
4. Klik på Send test. Tilbage i Zapier klikker du på Test trigger. Du ser prøveordren, #9999 til John Smith.
5. Tilføj den handling, du ønsker, for eksempel en ny række i Google Sheets, og kobl felterne: Order Number, Order Total, Order Customer Email og så videre.
6. Udgiv din Zap. Nu kører den ved hver betalt ordre.

Webhooks by Zapier er en af Zapiers premium-apps, så den kræver en betalt Zapier-plan.

Forbind med Make

1. Opret et scenarie i Make. Tilføj Webhooks og derefter Custom webhook, og klik på Add for at oprette en ny webhook.
2. Kopiér den adresse, som Make viser dig.
3. Tilføj en webhook med den adresse i Payly, og klik på Send test. Make læser prøven og registrerer felterne.
4. Tilføj de moduler, du ønsker, kobl felterne, og slå scenariet til.

Hændelser

• Ordre betalt: en ordre bliver betalt. Det gælder også et abonnements første betaling, hver fornyelse og en ordre, du selv tilføjer som betalt.
• Ordre afsendt: du markerer en ordre som afsendt. Når du sender en ordre i flere dele, bliver hver forsendelse sendt.
• Ordre refunderet: penge går tilbage, uanset om du refunderer i Payly eller i Stripe eller PayPal. Hver delvis refundering sendes også.
• Abonnement startet: et abonnements første ordre.
• Abonnement fornyet: hver betaling efter den første.
• Abonnement afsluttet: et abonnement opsiges eller udløber, på den dag det slutter.

Det sender Payly

Hver hændelse sendes som JSON. Alle ordrehændelser indeholder:

• Ordrenummeret, for eksempel #1000, dets status og tidspunktet for betalingen
• Delsummen, rabatten og rabatkoden, forsendelsen, momsen, totalen og det refunderede beløb samt valutaen
• Hver varelinjes navn, SKU, antal, pris og linjetotal
• Kundens navn, e-mail og telefonnummer samt leveringsadressen
• Hvordan der blev betalt, for eksempel med Stripe eller PayPal
• test_mode, som er sand for en ordre afgivet i testtilstand

Forsendelser tilføjer transportør og sporingsnummer. Refunderinger tilføjer det samlede refunderede beløb indtil nu. Abonnementshændelser tilføjer abonnementsplanen, dens pris, hvor ofte der faktureres, og datoen for næste fornyelse. En prøve fra Send test har "test": true. Kortnumre bliver hos Stripe og PayPal, så de er aldrig med i en webhook.

Hvis en webhook fejler

En app har 5 sekunder til at svare. Gør den ikke det, eller svarer den med en fejl, prøver Payly igen op til 7 gange mere over cirka fire og en halv time. Vinduet viser hver webhooks seneste leveringer, så du kan se, hvad der skete.

Hvis tre hændelser i træk mislykkes ved alle forsøg, sættes webhooken på pause, og skærmen Integrationer fortæller det. Tjek adressen, og klik derefter på Slå til igen.

Kontrollér, at en webhook kom fra din butik

Zapier og Make behøver ikke dette. Bygger du din egen app, har hver anmodning en X-Payly-Hmac-Sha256-header: anmodningens indhold signeret med HMAC-SHA256 ved hjælp af din butiks hemmelige signeringsnøgle, i base64. Nøglen findes i vinduet Webhooks. Beregn den samme signatur ud fra det rå indhold, og sammenlign de to.

Headeren X-Payly-Webhook-Id er den samme, når en levering forsøges igen, så din app kan springe en over, den allerede har behandlet.