Webhooks
Yurplan vous offre des possibilités quasi illimitées grâce aux webhooks !
Une fois configuré, un webhook permettra à Yurplan de vous envoyer vos données automatiquement via une requête HTTP(S) vous permettant ainsi de réagir à différent cas survenant au cours du cycle de vie de votre événement.
Chaque webhook est associé à un déclencheur, qui possède des données spécifiques, détaillées ci-dessous.
Commande validée et Modifiée
Dès qu'un participant s'inscrit à votre évènement, modifie ses données personnelles ou ses éventuels ateliers, vous recevrez les données suivantes :
{ "trigger": "ORDER_VALIDATED", "version": 1, "data": { "event": { "name": "John Doe Corp. Annual Meeting", "identifier": "ca612025-ebaf-4651-b13f-27975aaeafc6" }, "total": { "amount": "100.00", "currency": "EUR" }, "payment_reference": "YPTB0000057814", "payment_method": "CB_ONLINE", "buyer": { "first_name": "John", "last_name": "Doe", "email_address": "john.doe@yurplan.invalid" }, "answers": [ { "answer": ["69001"], "question": "Code postal" }, { "answer": ["John"], "question": "Prénom" }, { "answer": ["Doe"], "question": "Nom" } ], "tickets": [ { "token": "256617431735685270", "answers": [ { "answer": ["01/01/2000"], "question": "Date d'anniversaire" }, { "answer": [null], "question": "Adresse postale" }, { "answer": [null], "question": "Genre" } ], "last_name": "Doe", "first_name": "John", "identifier": "cce2fb2f-ba1e-4efa-905e-e90014974781", "ticket_type": { "name": "Simple", "amount": "10.00", "identifier": "72283cad-eec3-4942-8be6-00a27b78b387" }, "email_address": "john.doe@yurplan.invalid" }, { "token": "3747892655358460", "answers": [ { "answer": ["01/02/2000"], "question": "Date d'anniversaire" }, { "answer": ["1 Rue de la République Lyon 69001 France"], "question": "Adresse postale" }, { "answer": ["Femme"], "question": "Genre" } ], "last_name": "Doe", "first_name": "Jane", "identifier": "f03db27b-8f37-4230-b435-46d35fb94842", "ticket_type": { "name": "Simple", "amount": "10.00", "identifier": "72283cad-eec3-4942-8be6-00a27b78b387" }, "email_address": "jane.doe@yurplan.invalid" } ], "identifier": "1db5b8e5-ca2f-4a33-bd32-98beb3a4830d", "payment_date": "2020-01-01T11:00:00Z" } }
Scan d'un billet
Dès qu'un de vos participant sera scanné grâce à nos applications dédiées, vous recevrez les données suivantes :
{ "trigger": "ATTENDEE_CHECKED_IN", "version": "1", "data": { "check": { "direction": "IN", "scan_date": "2020-01-01T12:00:00Z" }, "event": { "name": "John Doe Corp. Annual Meeting", "identifer": "ca612025-ebaf-4651-b13f-27975aaeafc6" }, "ticket": { "token": "3747892655358460", "last_name": "Doe", "first_name": "Jane", "identifier": "f03db27b-8f37-4230-b435-46d35fb94842", "ticket_type": { "name": "Simple", "identifier": "72283cad-eec3-4942-8be6-00a27b78b387" }, "email_address": "jane.doe@yurplan.invalid" }, "scanlist": { "name": "Global" }, "checked_by": { "last_name": "Doe", "first_name": "John" } } }
Élément de commande annulé
Lorsqu'une commande a un élément (billet ou produit) annulé, les données suivantes vous seront envoyées :
{ "trigger": "ORDER_ITEM_CANCELED", "version": "1", "data": { "identifier": "d90ba818-c962-327e-8b06-5cc7926f2a41", "type": "ticket", "orderItemType": { "identifier": "028ec65d-3270-4e69-aa31-f7462b765369", "type": "ticket", "label": "SIMPLE TICKET", "originalPrice": { "amount": "20.0", "currency": "EUR" }, "vatRate": "30.0" }, "amount": { "amount": "20.0", "currency": "EUR" }, "event": { "identifier": "d4e54233-fa3d-153b-83ae-201e00ed1909", "name": "Opening Day" } } }
(Fonctionnalité Premium, activable depuis votre espace organisateur à partir du bouton Ajouter une application > Développeur > Demande d'activation)