Send bestillinger til Zapier, Make og andre apper med webhooks

En webhook sender hendelsene i butikken din til en annen app mens de skjer. Legg til en, så kan hver betalte bestilling nå Zapier eller Make, og derfra Google Sheets, Slack, e-postlisten din, regnskapsprogrammet ditt og tusenvis av andre. Du trenger ingen kode.

Legg til en webhook

1. Klikk på Integrasjoner i dashbordet for nettstedet ditt.
2. Under Automatisering slår du på Webhooks. Et vindu åpnes.

   

3. Velg en Hendelse, lim inn adressen appen din ga deg i Webhook-adresse, og klikk på Legg til webhook.
4. Klikk på Send test for å sende en prøvebestilling, og deretter på Ferdig.

   

Webhooks begynner å virke så snart du legger dem til. Du trenger ikke publisere.

Koble til Zapier

1. Opprett en Zap i Zapier. Velg Webhooks by Zapier som trigger, og deretter Catch Hook.
2. Kopier webhook-URL-en som Zapier viser deg.
3. I Payly legger du til en webhook for Bestilling betalt og limer inn den URL-en.
4. Klikk på Send test. Tilbake i Zapier klikker du på Test trigger. Du ser prøvebestillingen, #9999 for John Smith.
5. Legg til handlingen du vil ha, for eksempel en ny rad i Google Sheets, og koble feltene: Order Number, Order Total, Order Customer Email og så videre.
6. Publiser Zap-en. Nå kjøres den for hver betalte bestilling.

Webhooks by Zapier er en av Zapiers premium-apper, så det krever en betalt Zapier-plan.

Koble til Make

1. Opprett et scenario i Make. Legg til Webhooks, deretter Custom webhook, og klikk på Add for å lage en ny webhook.
2. Kopier adressen som Make viser deg.
3. I Payly legger du til en webhook med den adressen og klikker på Send test. Make leser prøven og finner feltene.
4. Legg til modulene du vil ha, koble feltene og slå på scenarioet.

Hendelser

• Bestilling betalt: en bestilling blir betalt. Dette gjelder også et abonnements første betaling, hver fornyelse og en bestilling du legger til for hånd som betalt.
• Bestilling sendt: du markerer en bestilling som sendt. Når du sender en bestilling i flere deler, sendes hver forsendelse.
• Bestilling refundert: penger går tilbake, enten du refunderer i Payly eller i Stripe eller PayPal. Hver delvise refusjon sendes også.
• Abonnement startet: et abonnements første bestilling.
• Abonnement fornyet: hver betaling etter den første.
• Abonnement avsluttet: et abonnement sies opp eller går ut, den dagen det avsluttes.

Hva Payly sender

Hver hendelse sendes som JSON. Alle bestillingshendelser inneholder:

• Bestillingsnummeret, for eksempel #1000, statusen og når den ble betalt
• Delsum, rabatt og rabattkode, frakt, avgift, totalt og refundert beløp, med valutaen
• Navn, SKU, antall, pris og linjesum for hver vare
• Kundens navn, e-postadresse og telefonnummer, og leveringsadressen
• Hvordan det ble betalt, for eksempel med Stripe eller PayPal
• test_mode, som er sann for en bestilling lagt inn i testmodus

Forsendelser legger til transportør og sporingsnummer. Refusjoner legger til det totale refunderte beløpet så langt. Abonnementshendelser legger til abonnementsplanen, prisen, hvor ofte den faktureres og datoen for neste fornyelse. En prøve fra Send test har "test": true. Kortnumre blir hos Stripe og PayPal, så de er aldri med i en webhook.

Hvis en webhook feiler

En app har 5 sekunder på seg til å svare. Gjør den ikke det, eller svarer den med en feil, prøver Payly på nytt opptil 7 ganger til over omtrent fire og en halv time. Vinduet viser de siste leveringene for hver webhook, så du kan se hva som skjedde.

Hvis tre hendelser på rad mislykkes ved alle forsøk, settes webhooken på pause, og skjermen Integrasjoner sier fra om det. Sjekk adressen, og klikk deretter på Slå på igjen.

Sjekk at en webhook kom fra butikken din

Zapier og Make trenger ikke dette. Bygger du din egen app, har hver forespørsel en X-Payly-Hmac-Sha256-header: innholdet i forespørselen signert med HMAC-SHA256 ved hjelp av butikkens signeringsnøkkel, i base64. Nøkkelen finner du i vinduet Webhooks. Regn ut den samme signaturen fra det rå innholdet, og sammenlign de to.

Headeren X-Payly-Webhook-Id er den samme når en levering prøves på nytt, så appen din kan hoppe over en den allerede har behandlet.