Instruction
Difficulty level:
Beheer > Integraties > GetYourGuide
Setting up GetYourGuide: authentication, mapping and checklist
Technical configuration of the GetYourGuide integration in i-Reserve. First do the product setup from the previous articles (participants + mirror object).
1. Authentication tab
| Field | What to enter |
|---|---|
| Supplier ID | Your supplier id as assigned by GetYourGuide. |
| Supplier name | Display name (for reporting/recognition). |
Under the hood i-Reserve uses Basic authentication for the outbound calls (pushing availability), and the inbound calls from GetYourGuide are verified via a central gateway with a signature (HMAC). These keys are arranged automatically when setting up the integration.
2. Details tab
| Field | What it does |
|---|---|
| Reservation status | Status a booking gets when GetYourGuide reserves (default 10). |
| Booking status | Status on booking confirmation (default 20). |
| Cancellation status | Status on cancellation (default 70). |
| Cutoff (seconds) | Minimum lead time before the start time at which booking is still allowed. |
| External id field | Booking field that stores the GetYourGuide reference. |
| Opening hours as default | Yes = availability as a time window (opening hours) by default; No = fixed time slots. Overridable per object. |
| Default duration (minutes) | Duration of a slot when no object duration is set. |
3. Mapping
- object → GetYourGuide product — link the (mirror) object to the GetYourGuide product id.
- participant → category — link each i-Reserve participant to a GetYourGuide category; add a fallback
*for the remaining participants. - extra → add-on type — (optional) link extras to an add-on type.
- object duration — (optional) the slot duration in minutes per object.
- opening hours yes/no — (optional) per object choose between time window or fixed slots.
After mapping, click Sync products to register the objects with GetYourGuide and fetch the external product ids.
4. Checklist
Preparation
- ☐ GetYourGuide supplier account with connectivity; Supplier ID known.
- ☐ Products/options created on the GetYourGuide side (categories, prices, texts).
- ☐ i-Reserve object with participants and prices configured.
- ☐ Mirror object (resource, without workflow) created and linked via a shared resource.
Configure & test
- ☐ Auth tab: Supplier ID + name filled.
- ☐ Details tab: statuses, cutoff, external-id field, opening-hours default and default duration set.
- ☐ Mapping: object→product, participant→category (+ fallback
*), optional extras/duration/opening-hours. - ☐ Sync products done; external product ids fetched.
- ☐ Availability reaches GetYourGuide (test panel: payload + send).
- ☐ Test flow: reservation → booking → cancellation run correctly; statuses match.
- ☐ E-tickets (QR) are returned and valid in the i-Reserve ticket control.
- ☐ No i-Reserve customer emails for GetYourGuide bookings (mirror object without workflow).
The GetYourGuide integration is still in beta/rollout. Align the first setup and go-live with i-Reserve.
Participants are required: without a participant-to-category mapping (and a "*" fallback) the integration does not offer the product. GetYourGuide always sells per participant category.
