Bestellingen naar Zapier, Make en andere apps sturen met webhooks

Voeg een webhook toe en Payly stuurt elke nieuwe bestelling, zending, terugbetaling en elk abonnement naar Zapier, Make of een andere app die webhooks accepteert.

Een webhook stuurt de gebeurtenissen van je winkel naar een andere app zodra ze plaatsvinden. Voeg er een toe, en elke betaalde bestelling kan bij Zapier of Make terechtkomen en vandaar bij Google Sheets, Slack, je e-maillijst, je boekhoudapp en duizenden andere apps. Je hebt geen code nodig.

Een webhook toevoegen

Klik in het dashboard van je site op Integraties.
Zet onder Automatisering Webhooks aan. Er opent een pop-up.
Kies een Gebeurtenis, plak het Webhook-adres dat je app je gaf en klik op Webhook toevoegen.
Klik op Test versturen om een voorbeeldbestelling te versturen en daarna op Klaar.

Webhooks werken zodra je ze toevoegt. Publiceren is niet nodig.

Koppelen met Zapier

Maak in Zapier een Zap. Kies als trigger Webhooks by Zapier en dan Catch Hook.
Kopieer de webhook-URL die Zapier laat zien.
Voeg in Payly een webhook toe voor Bestelling betaald en plak die URL.
Klik op Test versturen. Klik terug in Zapier op Test trigger. Je ziet de voorbeeldbestelling, #9999 voor John Smith.
Voeg de actie toe die je wilt, zoals een nieuwe rij in Google Sheets, en koppel de velden: Order Number, Order Total, Order Customer Email enzovoort.
Publiceer de Zap. Elke betaalde bestelling voert hem nu uit.

Webhooks by Zapier is een van de premium-apps van Zapier, dus je hebt een betaald Zapier-abonnement nodig.

Koppelen met Make

Maak in Make een scenario. Voeg Webhooks toe, dan Custom webhook, en klik op Add om een nieuwe webhook te maken.
Kopieer het adres dat Make laat zien.
Voeg in Payly een webhook met dat adres toe en klik op Test versturen. Make leest het voorbeeld en leert de velden kennen.
Voeg de modules toe die je wilt, koppel de velden en zet het scenario aan.

Gebeurtenissen

Bestelling betaald: een bestelling wordt betaald. Dit geldt ook voor de eerste betaling van een abonnement, elke verlenging en een bestelling die je met de hand als betaald toevoegt.
Bestelling verzonden: je markeert een bestelling als verzonden. Als je een bestelling in delen verzendt, wordt elke zending doorgestuurd.
Bestelling terugbetaald: er gaat geld terug, of je nu in Payly terugbetaalt of in Stripe of PayPal. Ook elke gedeeltelijke terugbetaling wordt doorgestuurd.
Abonnement gestart: de eerste bestelling van een abonnement.
Abonnement verlengd: elke betaling na de eerste.
Abonnement beëindigd: een abonnement wordt opgezegd of loopt af, op de dag dat het eindigt.

Wat Payly verstuurt

Elke gebeurtenis wordt als JSON verstuurd. Elke bestelgebeurtenis bevat:

Het bestelnummer, zoals #1000, de status en wanneer er is betaald
Het subtotaal, de korting en de kortingscode, de verzending, de belasting, het totaal en het terugbetaalde bedrag, met de valuta
De naam, SKU, het aantal, de prijs en het regeltotaal van elk artikel
De naam, het e-mailadres en het telefoonnummer van de klant, en het verzendadres
Hoe er is betaald, zoals met Stripe of PayPal
test_mode, dat true is bij een bestelling die in testmodus is geplaatst

Zendingen voegen de vervoerder en het trackingnummer toe. Terugbetalingen voegen het tot nu toe terugbetaalde totaal toe. Abonnementsgebeurtenissen voegen het plan, de prijs, hoe vaak er wordt gefactureerd en de datum van de volgende verlenging toe. Een voorbeeld van Test versturen bevat "test": true. Kaartnummers blijven bij Stripe en PayPal, dus ze staan nooit in een webhook.

Als een webhook mislukt

Een app heeft 5 seconden om te antwoorden. Doet hij dat niet, of antwoordt hij met een fout, dan probeert Payly het nog maximaal 7 keer opnieuw, verspreid over ongeveer vier en een half uur. De pop-up Webhooks toont de recente leveringen van elke webhook, zodat je kunt zien wat er is gebeurd.

Mislukken drie gebeurtenissen achter elkaar bij elke poging, dan wordt de webhook gepauzeerd en meldt het scherm Integraties dat. Controleer het adres en klik op Weer aanzetten.

Controleren of een webhook van je winkel komt

Zapier en Make hebben dit niet nodig. Bouw je zelf een app, dan heeft elk verzoek een header X-Payly-Hmac-Sha256: de inhoud van het verzoek, ondertekend met HMAC-SHA256 en de ondertekeningssleutel van je winkel, in base64. De sleutel staat in de pop-up Webhooks. Bereken dezelfde handtekening uit de onbewerkte inhoud en vergelijk de twee.

De header X-Payly-Webhook-Id blijft hetzelfde wanneer een levering opnieuw wordt geprobeerd, zodat je app een levering die al is verwerkt kan overslaan.