Integration Guide - Card Display iFrame | PCI Booking

Integration Guide - Card Display iFrame

In this scenario, the Booker has obtained the PCI BOOKING card-token and has also associated the card with the specific property using PCI SHIELD.

 

There are three integration points required:

  • Handling property activation

  • Handling ‘Reset password’ requests

  • Handling display of card data

 

Note - All URLs should be encoded!

Activation

The activation eMail will contain a link to the Booker portal. The link contains a querystring parameter ‘token=’. This allows the booker to display the property the usual portal they are accustomed to. Upon displaying the page, an iFrame should be opened, with the ‘src’ tag having the following data in it:

 

Usage:

<iframe src="https://users.pcibooking.net/Property/[BOOKER_ID]/Activation?token=[TOKEN FROM QUERYSTRING]"></iframe>

 

Where:

[BOOKER_ID]: The one assigned to the booker during account opening.

[TOKEN FROM QUERYSTRING]: The activation token obtained from the link in the eMail.

 

Example:

The activation link is:

https://portal.expedia.com/activate?token=F4dd9iM7bbf44eDxpLL016y

BOOKER_ID is “expedia”.

 

The iFrame statement should be:

<iframe src="https://users.pcibooking.net/Property/expedia/Activation?token=F4dd9iM7bbf44eDxpLL016y"></iframe>

Reset Password

The Reset Password eMail will contain a link to the Booker portal. The link contains a querystring parameter ‘token=’. This allows the booker to display the property the usual portal they are accustomed to. Upon displaying the page, an iFrame should be opened, with the ‘src’ tag having the following data in it:

 

<iframe src="https://users.pcibooking.net/Property/[BOOKER_ID]/ResetPassword?id=[TOKEN FROM QUERYSTRING]"></iframe>

 

Where:

[BOOKER_ID]: The one assigned to the booker during account opening.

[TOKEN FROM QUERYSTRING]: The activation token obtained from the link in the eMail.

 

Example:

The Reset password link is:

https://portal.expedia.com/rResetPassword?id=YYYTt55s0nb7Taiuy

BOOKER_ID is “expedia”.

 

The iFrame statement should be:

<iframe src="https://users.pcibooking.net/Property/expedia/ResetPassword?id=YYYTt55s0nb7Taiuy"></iframe>

Display Card

The display of card data is available after a card-token has been obtained by the Booker’s portal and has been granted access to a specific property using the PCI SHIELD service. This allows the booker to display the card data to the property within the usual portal they are accustomed to. Upon displaying the page, an iFrame should be opened, with the ‘src’ tag having the following data in it:

 

<iframe src="https://users.pcibooking.net/Property/[BOOKER_ID]/PaymentInfo?card_URI=[CARD_URI]"></iframe>

Where:

[BOOKER_ID]: The one assigned to the booker during account opening.

[CARD_URI]: The card URI is the resource identifier for the card location within PCI Booking. composed of card token and Path. Card_URI should be URL encoded.

 

 

The user (property) will be prompted for their credentials and once authenticated, the card form will be displayed.

 

Example:

<iframe src="https://usersqa.pcibooking.net/property/framebooker/PaymentInfo?card_URI=https%3A%2F%2Fservice.pcibooking.net%2Fapi%2Fpayments%2Fpaycard
%2F8f542a9edca44768ab8d186a0aaae13b"></iframe>