Request Structure

1. Client-Side (javascript/jquery/ajax): Add Signature as a Form value in the Request Body: This is the method to use if you are making the request to our API from javascript in the browser, i.e. a client-side request.
   OR
   
2. Server-Side: Add Signature to Request Header: This is a more straight-forward way to sign the request, but you can only use this method if you are calling our API directly from your server, not from javascript in the browser.
   

Client-Side: Adding the Signature as a Form value in the Request Body

1. You will need to provide a server-side method on your own server (the same host where your client pages are hosted) to return the signed hash value and add it to the request form.
   Here is a VB.Net version of this method (in a file named “signRequest.ashx”):
   
   
   
   Here is a PHP version of this method (in a file named “signedRequest.php”):
   
   
   
   
2. You can then call this method from your javascript. The data to be signed is the entire JSON request value. For e.g. {“method”:”step1”} or {"method":"vaultentry","reservationref":"123456ABCDEF","data":"vault  response data goes here"}
   For more info please see each method’s specific data requirements.
   
   Here is a sample javascript ajax call, using the “signRequest.ashx” .Net page as the signing method, and calling our “step1” API method:
   
   
   
   
3. Use the signed value and add it to the API request as a form value "signature":
   
   

Server-Side: Add Signature to Request Header

1. Get the API request input data. The data to be signed is the entire JSON request value. For e.g. {“method”:”step1”} or {"method":"vaultentry","reservationref":"123456ABCDEF","data":"vault response data goes here"}. For more info please see each method’s specific data requirements.
2. Use the hash secret to sign the data using HMACSHA256.
3. Add the hex encoded result to the header of the request as in a header value named “signature”. 
   

Add the hash result to the request header as:

signature: <hash>

PHP Example

To create the hash:

Example:

Curl request:

Response Structure

1. All fieldnames are lower case! Make sure you use lower case to access the correct field.
   
2. Please note that <int_id> is not the same as <int>, <int_id> refers to an integer value that reflects the ID within the RCM system for that particular dataset, and in case this value is 0 that means it is valid for all.
   Example:
   If we have the next Driver’s age table within the system:
   
   An age_id of 4 equals an age of 25. An age_id of 0 passed to a method means any age, in this case above 18, 19, 20, 25 and 26+

1. Add code in the $(document).ready function to get the booking details and then call the function that creates the GTM datalayer:
   
   
   
   
2. Create the dataLayer object and send it to GTM:
   
   
   

1. Add code in the $(document).ready function to get the booking details and then call the function that creates the GA transaction:
   
   
   
   
2. Add the transaction and items to the GA object and send it to Google: