Escape Room Partner Portal
Take bookings for your escape room through Austria's escape room aggregator.
List your escape room on escaperooms.at
No monthly fee and no setup cost. You pay a commission only on bookings that are confirmed.
How the partnership works
You pay only for confirmed bookings
There is no monthly fee and no cost to list a room. Commission is 15% of the booking value, charged per confirmed booking, and empty slots cost you nothing. Your balance, commissions and invoices are visible in the partner portal at any time.
If you take bookings on your own site through a promo link, we count the clicks we send you and settle the commission from the bookings you report back. Clicks themselves are never charged.
Three ways to connect
Connect your own booking system over our API, embed the booking widget on your site, or simply use a tracked promo link. You can switch method later in the integration settings.
Availability stays in sync
For API rooms we pull your schedule automatically, so the slots visitors see match your own system. Bookings made here are forwarded straight back to you.
Create Your Partner Account
Integration Documentation
Choose Your Integration Method
There are three ways to connect your escape room bookings with our platform:
- API Integration (Recommended): Provides real-time availability and direct booking capabilities. Requires technical setup on your end.
- Promo Code Link: Simple setup. We redirect users to your website with a unique code. You report confirmed bookings back to us periodically.
- Booking Widget: Embed a ready-to-use booking widget on your website. Visitors can book directly in-place.
You can select your preferred method when registering your room or change it later in the Integration Settings.
API Documentation
You need four endpoints on your side: list slots, verify one slot, book it, and cancel it. If you are not a technical expert, our support team can walk your developer through it.
Authentication
Authorization: Token YOUR_API_TOKEN
CORS Configuration
Important: Enable CORS on Your Server
You must configure your API server to allow cross-origin requests from our domain. Without this, the API connection test will fail with an error like:
Failed to load resource: Origin not allowed by Access-Control-Allow-Origin
How to enable CORS:
- Add the following headers to your API responses:
Access-Control-Allow-Origin: https://escaperooms.at
Access-Control-Allow-Methods: GET, PATCH, OPTIONS
Access-Control-Allow-Headers: Content-Type, Authorization
Access-Control-Allow-Origin: http://localhost:8000- Apache: enable-cors.org/server_apache.html
- Nginx: enable-cors.org/server_nginx.html
- Express.js: expressjs.com/cors
- Django: django-cors-headers
Required API Endpoints
Returns all available time slots for your room with prices.
Response Format:
[
{
"timestamp": 1444435200, // Unix timestamp in seconds
"available": true,
"price": 300
},
{
"timestamp": 1444435200,
"available": false,
"price": 300
},
{
"timeGame": "1444435200", // Alternative field name
"available": true,
"price": 700
}
]
Verifies if a specific time slot is available.
Response Format:
{
"available": true,
"price": 200
}
Book a specific time slot.
Request Format:
{
"username": "John",
"phone": "+380501234567",
"email": "email@mail.com",
"comment": "Good quest",
"fullPrice": 1000,
"discount": 20,
"discountPrice": 800,
"discountCardNumber": "a1234",
"giftCertificateNumber": "X987D5243",
"stock": "",
"countPlayers": 4
}
Cancel a booking for a specific time slot.
Response Format:
{
"success": true
}
Need Help with Integration?
Our technical team is available to assist with your API integration. We can help you implement these endpoints and ensure your system works seamlessly with our platform.
Contact us at hello@escaperooms.at
Embeddable Booking Widget
Add Online Booking to Your Website
Embed our booking widget directly on your website. Your visitors can browse available time slots and book without leaving your page. The widget automatically syncs with your schedule on our platform.
How It Works
1. Enable Widget
Ask your account manager to enable the widget for your room, or enable it in the admin panel.
2. Copy Embed Code
Copy the iframe snippet below and paste it into your website's HTML.
3. Receive Bookings
Visitors book directly on your site. You receive notifications and see bookings in your dashboard.
Embed Code
Copy the following code and paste it where you want the booking widget to appear on your website:
<iframe
src="https://escaperooms.at/widget/YOUR_ROOM_UUID/"
width="100%"
height="700"
frameborder="0"
style="border:none; border-radius:8px;"
></iframe>
Replace YOUR_ROOM_UUID with your room's unique ID. You can find it in your partner dashboard after registration.
Customization Options
You can customize the widget appearance by adding URL parameters:
| Parameter | Description | Example |
|---|---|---|
lang |
Widget language. Supported: de (German), en (English). Default: de | ?lang=en |
color |
Accent color as a hex code (without #). Used for buttons and highlights. | ?color=ff5733 |
Example with custom language and color:
<iframe
src="https://escaperooms.at/widget/YOUR_ROOM_UUID/?lang=en&color=28a745"
width="100%"
height="700"
frameborder="0"
></iframe>
Widget Features
- Weekly schedule view with navigation between weeks
- Real-time availability — booked slots are automatically greyed out
- Built-in booking form with validation
- Booking confirmation displayed directly in the widget
- Mobile-responsive design — works on phones, tablets, and desktops
- Spam protection via honeypot field
- Customizable accent color to match your brand
- Supports German and English
Technical Details
- The widget is served as a standalone HTML page designed for iframe embedding
- It uses Bootstrap 5 and jQuery (loaded from CDN, no conflicts with your site)
- Schedule data is fetched from our API: GET /api/room/{room_id}/schedule/?date=YYYY-MM-DD
- Bookings are submitted via POST to /widget/{room_id}/book/ as JSON
- CSRF protection is handled via a secure widget token
- The widget sets X-Frame-Options to allow embedding on any domain
Prerequisites
- The widget must be enabled for your room (widget_enabled = true)
- Your room must have schedules (time slots) configured on our platform
- Bookings made via the widget are marked with source 'WIDGET' in your dashboard
Partner Support
Our dedicated partner team is here to help you every step of the way. Whether you have questions about integration or need assistance with your account, we're here for you.
What the partnership includes
- No upfront costs
- Commission only on completed bookings
- Your listing in German and English
- API, booking widget or promo link
- Partner portal with bookings, payouts and invoices
Partnership Process
- Create an account
- Register your escape room
- Implement the API endpoints
- Connect and test your API
- Start receiving bookings!