Validating Membership Numbers using an Integrated Solution

Prerequisites for Validating Membership Numbers using an Integrated Solution

Membership numbers can be validated by an external service or solution, such as an external loyalty solution, using an outbound REST API. The membership number validation API accepts JSON responses from the integrated system.

Setup Requirements

1. Configure an Configuring Outbound System for the integrated CRM.

2. Configure an External Database for the CRM and select the Outbound System configured.

3. Update the Membership Type:

   1. Update Card Details, set Validation to External.

   2. Update Card Validation External Database, select the External Database. If the External Database is not updated, the Membership Number validation is performed through the External Database updated in Membership Handling.

   3. Update Membership Handling, select the External Database. Membership Number validation is performed through this External Database only when the Card Validation External Database in Card Number Validation is not updated.

REST Request

The following URL is posted to the service path of the integrated system.

Path Parameters:

• externalSystemCode: The external system to which the REST request is sent.

• chainCode: The OPERA Cloud tenant/chain code.

Query Parameters:

• membershipType: The membership type

• membershipNo: The membership number to be validated.

• hotelID: The ID at which this membership is being created.

Example: https://<externalsystem:port>/v1/externalSystems/{externalSystemCode}/chains/{chainCode}/validateMembershipNumber?membershipNo=87876&membershipType=XYZ&hotelId=PROP1

Table 15-4 Sample JSON Response

Successful

{      "links": [      {                 "href": "string",                  "rel": "string",                  "templated": false,                  "method": "GET",                  "targetSchema": "string",                  "operationId": "string",                  "title": "string"           }         ]       }

Unsuccessful

{          "errors": [          {              "errorsType": [              {                  "errorType": {                     "shortText": "Invalid Card Number",                     "code": "Error"              }           }         ]       }       ],       "links": [         {                 "href": "string",                 "rel": "string",                 "templated": false,                 "method": "GET",                 "targetSchema": "string",                 "operationId": "string",                 "title": "string"         }       ]     }