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
- Increase 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
Is this feature available to all Duve customers?
Yes. The feature is released and available in production.
What happens if some parameters are missing?
Only the parameters included in the URL will be pre-filled. Guests will need to manually complete any missing fields.
Can this be used with any OTA or external vendor?
Yes. Any partner capable of generating dynamic URLs with query parameters can use this feature.
Does this change the existing Online Check-In process?
No. It enhances the login step by reducing manual input. The rest of the Online Check-In flow remains unchanged.
Comments
0 comments
Please sign in to leave a comment.