Skicka beställningar till Zapier, Make och andra appar med webhooks

Lägg till en webhook så skickar Payly varje ny beställning, försändelse, återbetalning och prenumeration till Zapier, Make eller valfri app som tar emot webhooks.

En webhook skickar din butiks händelser till en annan app medan de inträffar. Lägg till en, så kan varje betald beställning nå Zapier eller Make, och därifrån Google Sheets, Slack, din e-postlista, ditt bokföringsprogram och tusentals fler. Du behöver ingen kod.

Lägg till en webhook

Klicka på Integrationer i webbplatsens kontrollpanel.
Under Automatisering aktiverar du Webhooks. En popup öppnas.
Välj en Händelse, klistra in adressen som din app gav dig i Webhook-adress och klicka på Lägg till webhook.
Klicka på Skicka test för att skicka en exempelbeställning och sedan på Klar.

Webhooks börjar fungera så fort du lägger till dem. Du behöver inte publicera.

Koppla till Zapier

Skapa en Zap i Zapier. Välj Webhooks by Zapier som trigger och sedan Catch Hook.
Kopiera webhook-URL:en som Zapier visar.
I Payly lägger du till en webhook för Beställning betald och klistrar in den URL:en.
Klicka på Skicka test. Tillbaka i Zapier klickar du på Test trigger. Du ser exempelbeställningen, #9999 för John Smith.
Lägg till den åtgärd du vill ha, till exempel en ny rad i Google Sheets, och koppla fälten: Order Number, Order Total, Order Customer Email och så vidare.
Publicera din Zap. Nu körs den för varje betald beställning.

Webhooks by Zapier är en av Zapiers premiumappar, så det kräver en betald Zapier-plan.

Koppla till Make

Skapa ett scenario i Make. Lägg till Webhooks, sedan Custom webhook, och klicka på Add för att skapa en ny webhook.
Kopiera adressen som Make visar.
I Payly lägger du till en webhook med den adressen och klickar på Skicka test. Make läser exemplet och lär sig fälten.
Lägg till de moduler du vill ha, koppla fälten och slå på scenariot.

Händelser

Beställning betald: en beställning betalas. Det gäller också en prenumerations första betalning, varje förnyelse och en beställning som du lägger till manuellt som betald.
Beställning skickad: du markerar en beställning som skickad. När du skickar en beställning i flera delar skickas varje försändelse.
Beställning återbetald: pengar går tillbaka, oavsett om du återbetalar i Payly eller i Stripe eller PayPal. Varje delåterbetalning skickas också.
Prenumeration startad: en prenumerations första beställning.
Prenumeration förnyad: varje betalning efter den första.
Prenumeration avslutad: en prenumeration sägs upp eller löper ut, den dag den tar slut.

Vad Payly skickar

Varje händelse skickas som JSON. Alla beställningshändelser innehåller:

Beställningsnumret, till exempel #1000, dess status och när den betalades
Delsumma, rabatt och rabattkod, frakt, moms, totalt och återbetalat belopp, med valutan
Varje artikels namn, SKU, antal, pris och radsumma
Kundens namn, e-postadress och telefonnummer samt leveransadressen
Hur det betalades, till exempel med Stripe eller PayPal
test_mode, som är sant för en beställning som lagts i testläge

Försändelser lägger till fraktbolag och spårningsnummer. Återbetalningar lägger till det totala belopp som återbetalats hittills. Prenumerationshändelser lägger till planen, dess pris, hur ofta den faktureras och datum för nästa förnyelse. Ett exempel från Skicka test har "test": true. Kortnummer stannar hos Stripe och PayPal, så de finns aldrig med i en webhook.

Om en webhook misslyckas

En app har 5 sekunder på sig att svara. Gör den inte det, eller svarar den med ett fel, försöker Payly igen upp till 7 gånger till under ungefär fyra och en halv timme. Popup-fönstret listar varje webhooks senaste leveranser, så att du kan se vad som hände.

Om tre händelser i rad misslyckas vid varje försök pausas webhooken, och skärmen Integrationer visar det. Kontrollera adressen och klicka sedan på Slå på igen.

Kontrollera att en webhook kom från din butik

Zapier och Make behöver inte detta. Om du bygger en egen app har varje förfrågan en X-Payly-Hmac-Sha256-header: förfrågans innehåll signerat med HMAC-SHA256 med din butiks signeringsnyckel, i base64. Nyckeln finns i popup-fönstret Webhooks. Räkna ut samma signatur från det råa innehållet och jämför de två.

Headern X-Payly-Webhook-Id är densamma när en leverans försöks igen, så att din app kan hoppa över en som den redan har hanterat.