Please check this page regularly for upcoming functionality and feature updates to pmsXchange v2.
To be removed / modified / added to the specification.
Payment Service Directive (PSD2) / Strong Customer Authentication (SCA)
Release Date: TBC
This change will include a WSDL schema update.
OTA_ResRetrieveRS
GuaranteeType
Element | Number | Description |
|---|---|---|
Guarantee / GuaranteesAccepted / GuaranteeAccepted / PaymentCard | 0..1 | Contains payment card information |
@CardCode | 0..1 | The 2 character code of the credit card issuer. Please see the OTA Payment Card Provider Codes table for reference |
| @CardType | 0..1 | The type of payment card, refer to the OTA Card Type code table for reference. Common usages are: 1: Credit |
@CardNumber | 0..1 | The number embossed on the payment card |
@ExpireDate | 0..1 | This is the expiry date of the payment card used in the format MMyy |
| @MaskedCardNumber | 0..1 | May be used to send a concealed or partial credit card number (e.g. "xxxxxxxxxxxx4444" or "4444"). |
| PaymentCard / ThreeDomainSecurity / Results | 0..1 | Transaction results. IMPORTANT NOTE: SCA / 3DS details will only be provided if received from an SCA / 3DS compatible booking agent. Information within the 'ThreeDomainSecurity' element will not be visible in The Channel Manager. |
| @ThreeDSVersion | 1 | The 3DS version used for authentication |
| @ECI | 1 | Electronic Commerce Indicator. Please see Electronic Commerce Indicator Codes table for reference. |
| @CAVV | 0..1 | Cardholder Authentication Verification Value (CAVV); Authentication Verification Value (AVV); Universal Cardholder Authentication Field (UCAF) |
| @PAResStatus | 0..1 | Transactions status result identifier. Please see Transactions Status Result Identifier Codes table for reference. |
| @SignatureVerification | 0..1 | Transaction Signature status identifier. Please see Transaction Signature Status Codes table for reference. |
| @XID | 0..1 | Transaction identifier resulting from authentication processing |
| @Enrolled | 0..1 | Status of Authentication eligibility. Please see Status of Authentication Codes table for reference. |
| @DSTransactionID | 0..1 | Unique transaction identifier assigned by the Directory Server (DS) to identify a single transaction |
| PaymentCard / CardHolderName | 0..1 | This is the name of the card holder. |
| Guarantee / Comments / Comment | 0..n | Contains extra information about the payment |
| @Name | 1 | The type of payment information, this can be one of PaymentGatewayName: The name of the payment gateway The comment Name will always be included if a Comment node is present here |
| Guarantee / Comments / Comment / Text | 1 | The actual information related to the payment |
| Guarantee / GuaranteeDescription | 0..1 | |
| Guarantee / GuaranteeDescription / Text | 1 | Information about the form of guarantee |
Reference Table Updates
Secure Customer Authentication
Status of Authentication Code
Value | Definition |
|---|---|
Y | Yes, Bank is participating in 3-D Secure protocol and will return the ACSUrl |
N | No, Bank is not participating in 3-D Secure protocol |
U | Unavailable, The DS or ACS is not available for authentication at the time of the request |
B | Bypass, Merchant authentication rule is triggered to bypass authentication in this use case |
Transactions Status Result Identifier Code
Value | Definition |
|---|---|
Y | Successful Authentication |
N | Failed Authentication |
U | Unable to Complete Authentication |
A | Successful Attempts Transaction |
| B | You can proceed to authorisation using the information received |
| R | Authentication Rejected (Merchant must not submit for authorisation) |
Transaction Signature Status Code
Value | Definition |
|---|---|
Y | Indicates that the signature of the PARes has been validated successfully and the message contents can be trusted. |
N | Indicates that the PARes could not be validated. This result could be for a variety of reasons; tampering, certificate expiration, etc., and the result should not be trusted. |
null | If not sent then null |
Electronic Commerce Indicator Code
Value | Definition |
|---|---|
02 or 05 | Fully Authenticated Transaction |
01 or 06 | Attempted Authentication Transaction |
00 or 07 | Non 3-D Secure Transaction |
| 02, 01, 00 | Mastercard |
| 05, 06, 07 | Visa |
| 05, 06, 07 | Amex |
| 05, 06, 07 | JCB |
| 05, 06, 07 | Diners |
Error Handling
Release Date: TBC
pmsXchange is migrating from the current legacy system to a microservices based new world architecture hosted in AWS. This pmsXchange internal upgradation comes with a set of advantages in terms of performance, scalability, robustness, faster development times, security and flexibility. This document lists the changes related to pmsXchange migration which will impact the PMS partners and an account of how some existing functionalities would behave in the new world.
What's happening now?
For the following error scenarios, wherein when OTA_HotelAvailNotif OR OTA_HotelAvailNotif RQ message from PMS provider is not processed successfully, pmsXchange responds back with a failure RS message which has the details of the error. P.S. refer Notes for the full list of error codes supported by pmsXchange.
Error Scenarios (Error Type = 3) -
- Room Type not mapped
- Channel Code not mapped
Error Type | Error Code | Error Reason | Error Message |
|---|---|---|---|
3 | 249 | Invalid Rate Code | Could not find any roomTypes for ‘Hotel XXXX’ matching InvTypeCode ‘XXXX’ and RatePlanCode ‘XXXX’ |
3 | 402 | Invalid Room Code | Could not find any roomTypes for ‘Hotel XXXX’ matching InvTypeCode ‘XXXX’ and RatePlanCode ‘XXXX’ |
3 | 783 | Room or Rate not found | Could not find any roomTypes for ‘Hotel XXXX’ matching InvTypeCode ‘XXXX’ and RatePlanCode ‘XXXX’ |
3 | n/a | Booking Agent Mapping missing | Booking agent mapping missing for HotelCode 'XXXX' and BookingAgentCode 'XXXX' and InvTypeCode 'XXXX' |
What's going to change?
For the following error scenarios, wherein when OTA_HotelAvailNotif OR OTA_HotelAvailNotif RQ message from PMS provider is not processed successfully, PmsXchange would still respond back with a success RS message with no details of the error.
Error Scenarios -
- Invalid Rate Code
- Invalid Room Code
- Room or Rate not found
- Booking Agent Mapping missing
However, pmsXchange will send the details of the error(s) via an automated email to the partner PMS and affected hotels. Details are as follows -
- An email would be generated twice a day at 8.00 am & 4.00 pm (timezone of the PMS partner)
Notes
See below the full list of error codes supported for pmsXchange.
Error Code | Error Reason | Error Message |
|---|---|---|
245 | Invalid Confirmation Number | Could not find Notifications to confirm with notification id XXXX |
392 | Invalid Hotel Code | Hotel with HotelCode XXXX does not exist |
375 | Hotel not Active | Hotel with HotelCode XXXX is not enabled for inventory updates |
249 | Invalid Rate Code | Could not find any roomTypes for ‘Hotel XXXX’ matching InvTypeCode ‘XXXX’ and RatePlanCode ‘XXXX’ |
402 | Invalid Room Code | Could not find any roomTypes for ‘Hotel XXXX’ matching InvTypeCode ‘XXXX’ and RatePlanCode ‘XXXX’ |
783 | Room or Rate not found | No room exists with InvTypeCode XXXX and RatePlanCode XXXX for hotelier XXXX |
448 | System error | |
450 | Unable to process | Each RatePlan must have a unique name |
Description cannot be more than 512 characters long | ||
| Hotelier XXXX has more than one room with the given room rate combination of InvTypeCode XXXX and RatePlanCode XXXX | ||
| Unable to create RoomType for Hotelier XXXX with the given room rate combination of InvTypeCode XXXX, RatePlanCode XXXX and InvTypeDescription XXXX | ||
| 737 | Throttle limit reached | |
| n/a | Booking Agent Mapping missing | Booking agent mapping missing for HotelCode 'XXXX' and BookingAgentCode 'XXXX' and InvTypeCode 'XXXX' |