Validating Membership Numbers using an Integrated Solution

Membership numbers can be validated in a CRM / loyalty solution integrated with OPERA Cloud, using a REST web service call. The membership number validation API accepts JSON responses from the integrated system.

Setup Requirements

  1. Configure an Configuring Outbound Systems  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 Membership Handling, select the External Database.

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-3 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"         }       ]     }