Pre-Fill Data with URL Parameters

Pre-populating data is a technique used in more advanced data exchange scenarios. If you want to make your online user experience more fluid and speed data input from your online user, Pre-Fill data is a powerful tool to help you reach your goal.

This technique is enabled via sending the users browser to a URL on the RESMARK Systems server along with appropriate URL parameters, that URL on the RESMARK Systems server then re-directs the user to the online reservation starting point or to an optional return URL specified by a URL parameter.

Pre-Fill URI

The base URI for Pre-Fill request is /res/prefill/. For example:

http://your-company.resmarksystems.com/res/prefill?promoCodes=ADV3

Many of the URL parameters (firstName, lastName, address etc.) are more appropriate when you already know who the online user is via some user profile in an existing system. Others (locationId,typeId, paymentAmount, autoMerge etc.) are more appropriate when you want to tailor the behavior or presentation of the system to suit the users expectations.

User Data URL Parameters

Parameter Name Format
firstName String The first name of the Guest making the online reservation.
Example: John
lastName String The last name of the Guest making the online reservation.
Example: Doe
birthDate MM/dd/yyyy The birth date of the Guest making the online reservation in MM/dd/yyyy format.
Example: 12/31/1974
gender String Either male or female.
email String The email of the Guest making the online reservation.
Example: username@example.com
phone Numeric Phone Number The 10 digit phone number of the Guest making the online reservation. No input validation is done on this format, so international numbers are just fine to use, but please include the full phone number so you can use this number later on. A 7 digit phone number is usually useless from a customer service perspective.
Example: 212-555-5555
address String The street address of the Guest making the online reservation.
Example: 123 St. James St.
city String The city of the Guest making the online reservation.
Example: Albany
state String The full name of the state, province or region of the Guest making the online reservation.
Example: New York
zip String The postal code of the Guest making the online reservation.
Example: 14051
country String The 2 character ISO 3166 country code of the Guest making the online reservation.
Example: US
medical String This parameter actually maps to a Guest level comment that will be applied to the primary Guest record on the created reservation.
Example: Diabetic with a Penut Alergy.
comments String The Reservation level comments that should be attached to the created reservation.
Example: VIP Guest.

Operational URL Parameters

Parameter Name Format
adSource Numeric The RESMARK Systems identifier for the Advertising Source linked to this sale.
Example: 5026
autoMerge Boolean If supplied, the created Reservation will be linked to the most recently created Person record in the system with the same email address supplied by this user (or the pre-fill parameter email). If no such Person record can be found, a new Person record is created.
Example: true
paymentAmount Multi-value String Restricts the user to the specfied Payment Amounts upon checkout. The available Payment Amount values are
  • FULL - allows the user to pay the full amount due for the reservation.
  • DEPOSIT - allows the user to pay only the deposit for the reservation.
  • DEPOSIT_SCHEDULE - allows the user to pay the deposit for the reservation and schedule the remainder of the reservation balance to be auto paid on the Balance Due Date linked to the Rate Plan for the activities booked on this reservation.
  • DIRECT_BILL - allows the user to pay a 3rd party sales agent. This is only available if there is an Agent logged in AND that Agent must be linked to a Travel Agency whith Direct Billing enabled AND the view URL parameter was set to AGENT.
The specified Payment Amounts are only respected if they would have been presented to the user in the first place. I.E.: you can't specify a Payment Amount that isn't applicable for the sale.
Example: FULL or for multiple values: paymentAmount=FULL&paymentAmount=DIRECT_BILL
view String Either CUSTOMER or AGENT.
agentId Numeric The RESMARK Systems identifier for the Agent getting commission for this sale.
Example: 215
agentFirstName String The first name of the Agent getting commission for this sale. This parameter is generally optional but is required when the Travel Agency this Agent is linked to allows Direct Billing.
Example: Suzie
agentLastName String The last name of the Agent getting commission for this sale. This parameter is generally optional but is required when the Travel Agency this Agent is linked to allows Direct Billing.
Example: Smith
redirect URL (escaped of course) A return URL once the Pre-Fill data has been recorded. Take care to ensure that this URL is properly escaped.
Example: http://www.mysite.com/trips/my-trip.php
locationId Numeric The RESMARK Systems identifier for the Location you wish to pre-select for the user.
Example: 12
typeId Numeric The RESMARK Systems identifier for the Item Type you wish to pre-select for the user.
Example: 5234
promoCodes Multi-value String The Promotional Code of a Discount you want to pre-apply for the user.
Example: PROMO or for multiple values: promoCodes=PROMO&promoCodes=UNIV&promoCodes=SENIOR