Webhooks
Met een webhook stuurt Tixxy een bericht naar je eigen software zodra er iets gebeurt, zoals een nieuwe bestelling of een check-in bij de ingang. Je koppeling hoeft dan niet steeds zelf te vragen of er iets veranderd is.
Wat heb je nodig?
- De API is ingeschakeld voor je organisatie (neem contact op met Tixxy)
- Het recht Webhooks beheren (
webhooks:manage) in je rechtengroep - Een adres (URL) van je eigen software dat berichten kan ontvangen, beginnend met
https://
Webhook toevoegen
- Ga naar Organisatie > Instellingen > Webhooks
- Klik op Webhook toevoegen
- Vul de URL in waar Tixxy de berichten naartoe stuurt
- Kies bij Berichten welke gebeurtenissen je wilt ontvangen
- Zet eventueel Persoonsgegevens meesturen aan (zie hieronder)
- Klik op Opslaan
Je krijgt daarna een signing secret te zien. Daarmee controleert je software dat een bericht echt van Tixxy komt. Je kunt het secret later opnieuw bekijken of vervangen via het menu naast de webhook.
Welke gebeurtenissen zijn er?
| Event | Wanneer? |
|---|---|
order.created | Er is een bestelling geplaatst, in de winkel, handmatig, via een import of via de API |
order.paid | Een bestelling op factuur is als betaald gemarkeerd |
order.cancelled | Een bestelling is geannuleerd |
order.refunded | Een terugbetaling voor een bestelling is afgerond |
ticket.checked_in | Een ticket is gescand bij de ingang |
ticket.invalidated | Een ticket is ongeldig gemaakt |
event.created | Er is een evenement aangemaakt |
event.updated | De naam, datums, verkoopperiode of locatie van een evenement is gewijzigd |
Persoonsgegevens
Standaard sturen we geen namen, e-mailadressen en antwoorden op formuliervelden mee. Zet Persoonsgegevens meesturen alleen aan als de ontvangende software deze gegevens mag verwerken, bijvoorbeeld je CRM.
Deze instelling kan alleen worden aangezet (en een webhook met persoonsgegevens kan alleen worden gewijzigd) door iemand die zelf toegang heeft tot bestellingen en tickets. Zo kan niemand persoonsgegevens naar een ander adres laten sturen.
Beperkt tot jouw evenementen
Heb je alleen toegang tot bepaalde evenementen? Dan ontvangt een webhook die jij aanmaakt ook alleen berichten over die evenementen.
Berichten controleren
Klik in het menu naast een webhook op Verzonden berichten om de laatste berichten te zien, met de status, het antwoord van je software en de inhoud. Met Resend stuur je een bericht nog een keer.
Met Test event versturen stuur je een testbericht, handig om je koppeling te controleren.
Als je software niet antwoordt
Je software moet binnen 10 seconden antwoorden met een statuscode in de 200-reeks. Lukt dat niet, dan proberen we het ongeveer een dag lang opnieuw, met steeds meer tijd ertussen.
Werkt de webhook meer dan drie dagen niet, dan zetten we hem uit en krijg je een e-mail. Los het probleem op en zet de webhook daarna weer aan via het menu.
Voor ontwikkelaars
Hoe je de handtekening controleert, hoe de berichten eruitzien en hoe je webhooks via de API beheert, lees je op developers.tixxy.nl.
Veelgestelde vragen
Ja, dat kan, bijvoorbeeld als je software het bericht wel verwerkte maar te laat antwoordde. Elk bericht heeft een uniek id. Sla dat op en sla berichten over die je al hebt verwerkt.
Een webhook die je hier aanmaakt, ontvangt alleen echte gegevens. Een webhook die je via de API met een testtoken aanmaakt, ontvangt alleen testgegevens.