Webhooks: Lad dine systemer tale sammen automatisk
Forestil dig, at du har bestilt en pakke fra en webshop. Du vil gerne vide, hvornår den bliver sendt.
Du kunne ringe til butikken hvert kvarter og spørge: "Er den sendt nu?" Svaret vil stort set altid være det samme: "Nej, ikke endnu."
Først efter du har brugt både din egen og butikkens tid, får du endelig beskeden: "Pakken er sendt afsted."
Det er tungt og helt unødvendigt. I stedet kunne du bare sige: "Giv mig besked, når den er sendt."
Det er præcis sådan webhooks fungerer. En webhook er en besked mellem systemer: "Sig til mig, når noget sker." I stedet for konstant at spørge (det der kaldes polling), bliver du automatisk informeret, når der sker noget relevant.
Eller sagt på en anden måde: Polling er at stå i vinduet og glo efter postbuddet hele dagen. En webhook er at modtage en besked, når pakken er i postkassen.
Hvad sker der bag kulisserne?
Når en kunde gennemfører en betaling i din webshop, kører der en hel kædereaktion. Betalingen bliver godkendt, pengene reserveret, ordren oprettet, kvitteringer sendt. Alt sammen på få sekunder, ofte på tværs af flere systemer.
Den del klarer din betalingsløsning og din webshop allerede. Det sker via en notifikations-URL, der er bygget ind i betalingsflowet. Du behøver ikke gøre noget ekstra.
Men hvad nu, hvis du har brug for at et andet system også får besked? Måske dit regnskabsprogram. Måske et lagersystem. Måske en automatisering der sender en intern Slack-besked, når noget går galt.
Det er her webhooks kommer ind. De er et separat notifikationssystem, der kan sende beskeder til systemer udenfor selve betalingsflowet.
Webhooks i ePay
Okay, men hvad kan du egentlig bruge det til? Her er tre situationer vi ser hos vores kunder:
Nyt abonnement oprettet? Giv dit CRM besked. En kunde tilmelder sig et abonnement i din webshop. Med en webhook på subscription-billing.agreement-active.v1 kan du automatisk oprette kunden i dit CRM, trigge et velkomstflow eller give dit salgsteam besked. Det sker i det øjeblik abonnementet aktiveres - ikke næste gang nogen husker at tjekke.
Automatisk bogføring ved gennemført betaling En kunde betaler i din webshop, og du vil have det registreret i dit regnskabssystem med det samme. Med en webhook på transaction.success.v1 kan du automatisk sende transaktionsdata videre til bogføringen, så du slipper for at gøre det manuelt.
Intern notifikation ved fejlede transaktioner Du har brug for at dit team får besked med det samme, når en betaling fejler. Med en webhook på transaction.failed.v1 kan du sende en notifikation til Slack, Teams eller et andet system, så der kan reageres hurtigt.
Det kræver lidt fra din side
Webhooks kræver et endpoint - altså en adresse der kan tage imod beskederne. Det kan være en URL på din egen server, eller et no-code-værktøj som Make eller Zapier, der håndterer det hele uden en eneste linje kode.
Nogle systemer har du ikke brug for webhooks til overhovedet. Bruger du f.eks. e-conomic, har ePay en direkte integration der automatisk opretter kladdeposteringer, når en betaling gennemføres. Men bruger du et regnskabssystem vi ikke har en færdig integration til, er en webhook den nemmeste vej til at få dine systemer til at tale sammen.
Sådan sætter du det op
I ePays backoffice finder du webhooks under Udviklere > Webhooks. Her kan du oprette op til 10 webhooks, hver med sin egen URL og et valgfrit sæt events.
De events du kan lytte på i dag:
- transaction.failed.v1 - Sendes når en transaktion fejler.
- transaction.success.v1 - Sendes når en transaktion gennemføres.
- subscription-billing.charge-failed.v1 - Sendes når en abonnementsopkrævning fejler.
- subscription-billing.charge-success.v1 - Sendes når en abonnementsopkrævning gennemføres.
- subscription-billing.charge-created.v1 - Sendes når en abonnementsopkrævning oprettes.
- subscription-billing.agreement-active.v1 - Sendes når en abonnementsaftale bliver aktiv.
- subscription-billing.agreement-stopped.v1 - Sendes når en abonnementsaftale stoppes.
- settlement.transfer-ready.v1 - Sendes når en settlement-overførsel er klar.
Når du opretter en webhook, angiver du tre ting:
- En URL: det endpoint, der skal modtage beskederne. Det kan være en URL på din egen server, eller en URL fra et automationsværktøj som Make eller Zapier.
- En Authorization-header: en hemmelig nøgle som sendes med hver webhook. Det er din sikkerhed for at beskederne faktisk kommer fra ePay og ikke fra nogen, der udgiver sig for at være os.
- Et eller flere events: de hændelser, du vil have besked om.
Når din webhook er oprettet, dukker den op i oversigten. Derfra kan du teste den, sætte den på pause eller redigere.
Klar til at komme i gang?
Hvis du har systemer der skal tale sammen, er webhooks en af de nemmeste måder at få det til at ske. Den fulde API-dokumentation finder du på docs.epay.eu
Ikke ePay-kunde endnu? Opret en gratis testkonto og prøv det selv: app.epay.eu/register
