Website en koppelingen
By Henrico
By Henrico
Je ticketshop op je eigen website, doorsturen na de aankoop en de API.
Ticketshop op je website plaatsen
Je kunt je Tickable ticketshop op twee manieren aan je website toevoegen: via een link of door de shop in te bedden. Optie 1: Link naar je ticketshop De snelste manier. Voeg een knop of link toe die bezoekers naar je ticketshop stuurt. 1. Ga naar je activiteit in het Tickable dashboard 2. Klik op "Delen" rechtsboven 3. Kopieer de URL van je ticketshop 4. Plaats deze link op je website, bijvoorbeeld in een knop <a href="https://jouwnaam.tickable.nl/jouw-evenement" class="button">Tickets kopen</a> Werkt op elke website, geen technische kennis nodig. Wil je één knop voor al je activiteiten? Kies dan in "Delen" bovenin "Alle activiteiten" en gebruik https://jouwnaam.tickable.nl. Zie Ticketshop delen met link of QR-code. Optie 2: Ticketshop embedden Hiermee kunnen bezoekers tickets kopen zonder je website te verlaten. 1. Open je activiteit in het dashboard 2. Klik op "Delen" rechtsboven 3. Klik op "Integreren op jouw website" 4. Kopieer de HTML-code 5. Plak de code op de plek waar de ticketshop moet verschijnen De code ziet er zo uit: <iframe src="https://jouw-ticketshop.tickable.nl/activiteit" class="tickable-shop" frameborder="0"> </iframe> <script src="https://jouw-ticketshop.tickable.nl/embedded.js"></script> De iframe past zich automatisch aan. Bezoekers blijven op je eigen website en kunnen daar direct afrekenen. Let op: zorg dat de iframe op de pagina zelf meteen zichtbaar is. De bezoeker wordt na het betalen teruggestuurd naar de URL waarin het iframe zich bevindt. Na de aankoop terug naar je eigen website Wil je kopers na het afrekenen naar een eigen bedankpagina op je website sturen, in plaats van de bevestigingspagina van Tickable? Zet dan per evenement Eigen bedankpagina aan onder Meer instellingen. Hoe dat werkt lees je in Na aankoop doorsturen naar je website. Google Tag Manager op je website Gebruik je Google Tag Manager op je website? Staat de ticketshop ingebed met de code hierboven, dan komen de stappen vanzelf in de dataLayer van je pagina, in het e-commerceformaat van Google Analytics 4: - view_item: de ticketshop is bekeken - add_to_cart: een ticket is toegevoegd - begin_checkout: de koper vult zijn gegevens in - purchase: de bestelling is betaald, met het bedrag en de tickets In Tag Manager maak je per stap een trigger van het type Aangepaste gebeurtenis met die naam. Er gaat niks over de koper mee, alleen tickets en bedragen. Bij purchase is het transaction_id het korte bestelnummer dat de koper ook in zijn mail ziet. Tag Manager zelf kun je niet in de ticketshop zetten. Wil je Google Analytics, Meta of TikTok rechtstreeks koppelen, lees dan Advertenties en Google Analytics koppelen. Hulp nodig? Loop je vast? Neem contact met ons op, we helpen je graag.
Na aankoop doorsturen naar je website
Na het afrekenen ziet een koper standaard de bevestigingspagina van Tickable. Wil je dat bezoekers daarna automatisch terugkomen op je eigen website, bijvoorbeeld op een bedankpagina? Dat stel je per evenement in met Eigen bedankpagina. Instellen 1. Ga naar Activiteiten en open je evenement 2. Klik in het menu onder Instellingen op Meer instellingen 3. Zet bij Activiteit functies de schakelaar Eigen bedankpagina aan 4. Vul bij Bedankpagina URL het adres in waar kopers naartoe moeten, bijvoorbeeld https://jouwwebsite.nl/bedankt 5. Klik op Opslaan Wil je het adres later aanpassen? Klik dan op Instellen naast de schakelaar. Zet je de schakelaar uit, dan wordt het adres verwijderd en zien kopers weer de standaard bevestigingspagina van Tickable. Zie je Meer instellingen niet? Dan heb je geen rechten om evenementen te bewerken. Vraag een beheerder van je organisatie om het in te stellen. Wat merkt de koper? - Zodra de bestelling gelukt is, gaat de koper direct naar jouw pagina. Dat geldt ook voor gratis bestellingen. - Mislukt de betaling, dan blijft de koper in de ticketshop en kan die het opnieuw proberen. - De tickets worden zoals altijd per e-mail verstuurd. Zet dat gerust op je bedankpagina, want de koper ziet de bevestigingspagina van Tickable niet meer. Goed om te weten - Per evenement: de bedankpagina geldt alleen voor het evenement waar je hem instelt. Kopieer je een evenement via Activiteit kopiëren, dan neemt de kopie de bedankpagina over. - Ingebedde ticketshop: staat de ticketshop op je website via Delen > Integreren op jouw website? Gebruik dan de volledige code, inclusief de regel met embedded.js. Dat script zorgt dat je hele pagina doorgaat naar de bedankpagina, en niet alleen het venster van de ticketshop. - Geen bestelgegevens in de link: de koper gaat naar precies het adres dat je invult. Er worden geen gegevens zoals het bestelnummer aan toegevoegd. - Test het even: doe na het instellen zelf een testbestelling, zodat je zeker weet dat kopers op de goede pagina uitkomen. - Alleen de mail en het ticket bekijken? Stuur jezelf een testticket vanuit de eerste stappen op het Overzicht van je activiteit. Dat telt nergens mee, maar gaat niet langs je bedankpagina. Zie Testticket sturen. Lees ook: Ticketshop op je website plaatsen.
API en webhooks
Tickable heeft een API waarmee je evenementen, bestellingen en tickets kunt ophalen, tickets kunt scannen en webhooks kunt instellen. Handig als je Tickable wilt koppelen aan je eigen website, CRM, boekhoudsoftware of andere systemen. De volledige technische documentatie vind je op docs.tickable.io. Wat kun je met de API? Via de API kun je je evenementen en tijdsloten ophalen, bestellingen en tickets inzien (inclusief de antwoorden op je vragen), tickets scannen vanuit je eigen systeem, en webhooks instellen zodat je automatisch een melding krijgt als er een bestelling is betaald. Evenementen en bestellingen aanmaken of wijzigen kan (nog) niet via de API. Hoe begin ik? Om aan de slag te gaan heb je een API-sleutel nodig: 1. Klik in het menu links op Instellingen en ga naar API (app.tickable.nl/settings/developers). Zie je API niet? Zet het dan eerst aan onder Meer instellingen en klik op Instellen. 2. Klik op API-sleutel aanmaken 3. Geef de sleutel een Naam, bijvoorbeeld "CRM-koppeling" 4. Kies bij Rechten wat de sleutel mag, bijvoorbeeld Evenementen lezen of Tickets lezen 5. Kies een Vervaldatum: geen, of na 30, 90 of 365 dagen 6. Klik op Sleutel genereren Kopieer de sleutel meteen: je kunt hem daarna niet meer bekijken. In de lijst zie je per sleutel wanneer die voor het laatst is gebruikt. Elke API-aanroep bevat je sleutel als Bearer-token in de Authorization-header. Een voorbeeld: curl https://api.tickable.io/events \ -H "Authorization: Bearer tk_live_JOUW_API_SLEUTEL" Binnen twee minuten kun je zo je eerste evenementen ophalen. Authenticatie Er zijn twee manieren om te authenticeren: - API-sleutel — ideaal voor directe server-naar-server koppelingen, zoals een synchronisatie met je eigen database of boekhouding. - OAuth2 — bedoeld voor situaties waarin een externe applicatie namens een Tickable-gebruiker toegang nodig heeft, bijvoorbeeld een integratie die je voor meerdere organisaties aanbiedt. Wil je OAuth2 gebruiken? Neem dan contact met ons op. De meeste organisaties komen prima uit met een API-sleutel. Rechten Bij het aanmaken van een API-sleutel kies je precies wat de sleutel mag: - Evenementen lezen — evenementen, tickettypes en tijdsloten ophalen - Bestellingen lezen — bestellingen inzien - Tickets lezen — tickets ophalen - Tickets schrijven — tickets scannen - Webhooks lezen — webhooks bekijken - Webhooks schrijven — webhooks aanmaken en verwijderen Webhooks Met een webhook stuurt Tickable automatisch een bericht naar jouw systeem als er een bestelling is bevestigd: de bestelling is betaald en de tickets zijn gemaakt (order.confirmed). Zo hoef je niet zelf steeds te controleren of er iets is veranderd. Andere gebeurtenissen, zoals een gescand ticket, zijn er nog niet. Een webhook maak je onder Instellingen > API met Webhook toevoegen: - Endpoint URL — het adres waar het bericht naartoe gaat - Beschrijving — voor jezelf - Gebeurtenistypes — kies Bestelling bevestigd - Ondertekeningsgeheim — optioneel. Vul je dit in, dan krijgt elk bericht een header X-Webhook-Signature: sha256=…, een HMAC-SHA256 van de body met dit geheim. Zo controleer je dat het bericht echt van Tickable komt. Het bericht bevat de bestelling, het evenement en het tijdslot. Klik op een webhook om de Aflevergeschiedenis te zien, met per bericht de status en wat er is verstuurd en teruggekregen. Mislukt een bericht, dan proberen we het nog een paar keer opnieuw. Meer informatie De volledige API-referentie, voorbeelden in cURL, Node.js en Python, en uitleg over paginering en webhooks vind je in de developer-documentatie: docs.tickable.io. Loop je ergens tegenaan? Neem dan contact met ons op via tickable.nl.