Ga naar inhoud
Wink

Webhook-integratie

Webhooks laten je systemen realtime meldingen ontvangen wanneer er gebeurtenissen plaatsvinden op je Wink-account — nieuwe boekingen, annuleringen, betalingsupdates en meer. Deze gids begeleidt je bij de setup en beste praktijken.

Doelgroep

Section titled “Doelgroep”

Deze gids is bedoeld voor ontwikkelaars die Wink integreren met externe systemen zoals property management systemen (PMS), channel managers, CRM’s of aangepaste dashboards.

Hoe webhooks werken

Section titled “Hoe webhooks werken”
  1. Je registreert een webhook-URL op Wink.
  2. Wanneer een gebeurtenis plaatsvindt (bijv. een nieuwe boeking), stuurt Wink een HTTP POST naar jouw URL.
  3. Je server verwerkt de payload en reageert met een 200 OK.

Een webhook instellen

Section titled “Een webhook instellen”
  1. Log in op je account (Extranet, Studio of TripPay — allemaal ondersteunen webhooks).
  2. Ga naar Applications en vervolgens Webhooks. Zie Webhooks.
  3. Klik op Create webhook.
  4. Voer een naam in (bijv. “PMS Booking Sync”).
  5. Voer je webhook-URL in — het HTTPS-eindpunt op je server.
  6. Selecteer gebeurtenissen — Kies specifieke gebeurtenissen om op te abonneren, of laat leeg om alle gebeurtenissen te ontvangen.
  7. Zet Enabled aan.
  8. Klik op Save.

Gebeurtenistypen

Section titled “Gebeurtenistypen”

Wink ondersteunt 64+ webhook-gebeurtenistypen in categorieën zoals accountbeheer, boekingscontracten, betalingen, channel manager-updates en beheer van entiteitenadministratie. Veelvoorkomende gebeurtenissen zijn:

CategorieVoorbeelden
Boekingbooking.create, booking.cancelled
Boekingscontractbooking.contract.created, booking.contract.processing, booking.contract.cancelled
Betalinginternal.payment.succeeded, internal.payment.failed
Terugbetalingenbooking.contract.refund.partial, booking.contract.refund.full
Channel managerchannel-manager.update.rate, channel-manager.update.availability
Accountaccount.create, account.status.updated

Voor een volledige lijst van alle gebeurtenistypen met beschrijvingen, zie de Webhook Events Catalog.

Bekijk alle 64+ gebeurtenistypen

Beste praktijken

Section titled “Beste praktijken”
  • Gebruik HTTPS — Wink stuurt payloads alleen naar HTTPS-eindpunten.
  • Reageer snel — Geef zo snel mogelijk een 200 OK terug zodra je de payload ontvangt. Voer zware verwerking asynchroon uit.
  • Idempotentie — Je handler moet idempotent zijn. Wink kan de levering opnieuw proberen als er geen 200-antwoord wordt ontvangen.
  • Valideer de bron — Verifieer dat binnenkomende verzoeken van Wink afkomstig zijn voordat je ze verwerkt.
  • Logging — Log elke webhook-payload die je ontvangt. Dit maakt het debuggen van integratieproblemen veel eenvoudiger.

Pauzeren en verwijderen

Section titled “Pauzeren en verwijderen”

Je kunt een webhook uitschakelen zonder deze te verwijderen. Dit pauzeert de levering zodat je kunt troubleshooten zonder je configuratie te verliezen. Wanneer je klaar bent, zet je hem weer aan.

Het verwijderen van een webhook verwijdert deze permanent. Elke integratie die afhankelijk is van die webhook ontvangt dan geen meldingen meer.

Verdere lectuur

Section titled “Verdere lectuur”