Overview
Duve enables external vendors, OTAs, and travel agents to generate direct links to Duve’s Online Check-In (OCI) portal with pre-filled guest information using URL query parameters.
When guests click these personalized links, their booking details are automatically populated in the login form, allowing them to proceed to Online Check-In quickly and without manual data entry.
Benefits Include:
- Reduced friction in the guest journey
- Increased Online Check-In conversion rates for hosts with missing guest details
- Lower support burden for property staff
- Improved guest satisfaction
- Competitive advantage for properties using Duve
This functionality is available to all Duve customers.
How it Works
- Partner Generates the Link
Partner embeds a pre-filled Check-In Portal URL in the guest voucher with booking data.
- Guest Clicks Link
Form fields are auto-populated from URL parameters. No manual data entry needed.
- Instant Check-In
Guest clicks Login and proceeds directly to Online Check-In flow.
How to Set Up
First navigate to Settings > General > Guest Login
Hotels must enable the appropriate login method (Email, Phone, Booking Number, or Full Name + Dates).
If a login method is disabled, the corresponding Sign-in Option (sio) value will not work.
Next navigate to Settings > Check-In > Check-In Portal and enable the Check-In Portal toggle.
Copy the Base URL
Each hotel has a unique portal URL in the format:
https://m.duve.co/cip/{portalId}
Append Parameters
Add query parameters with guest data to pre-fill the login form.
Important Notes
The Check-In Portal link must be configured at the brand level, not at the account level.
Each brand should have its own unique Check-In Portal link.
Attribution (affType)
Use the affType parameter to track which partner generated the check-in.
This value is captured as the UTM source after a successful login.
Default Recommendation
Use
sio=3(Booking Number) when the partner has access to the reservation ID.If the reservation ID is not available, use
sio=7as a fallback.
Valid Sign-in Option (sio) Values:
1 - Email
- Email-based login
- Pre-fills email, check-in date
- Fields: email, checkInDate
2 - Phone
- Phone-based login
- Pre-fills phone number, check in date
- Fields: phoneNumber, checkInDate
3 - Booking Number
- Reservation ID login
- Pre-fills booking number and check-in date
- Fields: externalId, checkInDate
7 - Full Name + Dates
- Name and dates login
- Pre-fills first and last name, check-in/out dates
- Fields: firstName, lastName, checkInDate, checkOutDate
Complete URL Parameter List:
Example URLs
Email login with pre-filled data
?sio=1&email=john@example.com&firstName=John&lastName=Doe&checkInDate=2025-11-30&affType=ota1
Phone login with pre-filled phone
?sio=2&phoneNumber=1234567890&firstName=John&lastName=Doe&checkInDate=2025-11-30&affType=ota1
Booking number with dates
?sio=3&externalId=BK123&checkInDate=2025-11-27&affType=ota1
Full name with checkout date
?sio=7&firstName=John&lastName=Doe&checkInDate=2025-11-27&checkOutDate=2025-11-29&affType=ota1
FAQ
Q: Is this feature available to all Duve customers?
A: Yes. The feature is released and available in production.
Q: What happens if some parameters are missing?
A: Only the parameters included in the URL will be pre-filled. Guests will need to manually complete any missing fields.
Q: Can this be used with any OTA or external vendor?
A: Yes. Any partner capable of generating dynamic URLs with query parameters can use this feature.
Q: Does this change the existing Online Check-In process?
A: No. It enhances the login step by reducing manual input. The rest of the Online Check-In flow remains unchanged.
Comments
0 comments
Article is closed for comments.