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
Dès qu'un participant s'inscrit à votre évènement, 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": "EURO" }, "answers": [{ "answer": ["69001"], "question": "Code postal" }, { "answer": ["John"], "question": "Pr\u00e9nom" }, { "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", "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\u00e9publique 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", "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é disponible seulement pour les organisateurs ayant souscrit à l’offre Marketing & Communication)