What is the Reservations Integration?
Papaya's Reservations Integration lets booking platforms like SevenRooms, Bistrochat, and other partners talk directly to your POS. When a guest books a table through your reservation system, Papaya automatically opens an order on the correct table, captures guest details, and records any deposit — so your team is ready the moment the guest walks in.
The connection runs on Papaya's OpenAPI — a secure, key-based integration layer that partners use to create reservations, receive status updates via webhooks, and keep both systems in sync in real time.
Why merchants love it
No double entry. Reservations created in your booking platform appear instantly in Papaya. Your staff don't re-type guest names, party size, or table assignments.
Tables held automatically. Papaya marks the table as occupied the moment the reservation is created, preventing double-bookings and walk-in conflicts.
Deposits tracked in the POS. If the guest paid a deposit through the reservation platform, Papaya records it as a pre-paid amount on the order — so the bill shows the correct balance when the guest settles.
Guest profile carried over. First name, last name, email, phone number, and reservation notes are attached to the order and visible to staff.
Live status sync. When your team updates the order in Papaya (guest seated, items added, bill closed), the reservation platform gets a webhook update automatically.
Works with any compatible partner. The same integration powers SevenRooms, Bistrochat, and custom in-house booking tools — one setup, many partners.
How it works
Here's what happens behind the scenes when a reservation is made:
A guest books a table in the reservation platform (SevenRooms, Bistrochat, etc.).
The partner calls Papaya's OpenAPI with the booking details.
Papaya opens a new order on the correct dine-in table, tagged with the guest's information and any deposit paid.
Your staff see the reservation in Papaya, ready for the guest's arrival.
As the order progresses (items added, payment taken, order closed), Papaya sends webhook updates back to the reservation platform.
‼️ For the integration to work, the outlet must be open, the target channel must be a dine-in channel, and at least one table must be available. Papaya will reject the reservation if no table is free.
What gets captured on each reservation
Partner name (e.g. SevenRooms, Bistrochat) and the partner's reservation ID
Guest first name (required), last name, email, phone number
Reservation notes (allergies, special requests, seating preferences)
Guest count
Assigned table / dine-in channel
Any deposit or advance payment already collected by the partner
Setting it up
The integration is turned on per outlet. Once enabled, Papaya generates an API key that your reservation partner uses to connect.
In the merchant dashboard, enable Reservations as a use case for your outlet.
Create a new OpenAPI key with the Reservations use case.
Configure a webhook URL — this is where Papaya will send order status updates for the partner to consume.
(Optional) Enable Notify all orders if the partner needs updates for every reservation order at the outlet.
Share the API key with your reservation partner so they can start sending bookings.
Day-to-day workflow
Booking arrives. A reservation is created in SevenRooms / Bistrochat → Papaya opens a matching order on the reserved table.
Guest is seated. Staff tap the reservation in Papaya, see the guest's name and notes, and start adding items.
Deposit is applied. Any pre-paid amount shows on the bill; the guest only pays the remaining balance.
Order closes. Papaya fires a webhook to the reservation platform so the booking is marked as completed there too.
Frequently asked questions
Which reservation platforms are supported?
Any platform that integrates with Papaya's OpenAPI. SevenRooms and Bistrochat are live today. Additional partners can build against the same endpoints.
What if the guest modifies their reservation?
The partner system can update the order through the same API — guest count, table, and notes all stay in sync.
Can I use reservations alongside walk-in orders?
Yes. Reservation orders and walk-in orders live side by side in Papaya. Reserved tables are held, and free tables remain available for walk-ins.
What happens if no table is free?
Papaya rejects the reservation. Your booking platform should prevent overbooking based on your floor plan.
For more background on reservation use cases at Papaya, see our developer guide.
Related articles
🛌 Cloudbeds Integration — Hotel PMS integration for bill-to-room charges