{"id":28577617,"url":"https://github.com/mastercard/loyalty-airport-reference-app","last_synced_at":"2025-08-19T20:11:33.357Z","repository":{"id":39945933,"uuid":"233628425","full_name":"Mastercard/loyalty-airport-reference-app","owner":"Mastercard","description":"Loyalty Airport API reference application using Open API generator","archived":false,"fork":false,"pushed_at":"2023-03-23T15:53:16.000Z","size":116,"stargazers_count":0,"open_issues_count":2,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-08-02T17:37:13.482Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mastercard.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"License.txt","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2020-01-13T15:31:01.000Z","updated_at":"2021-12-17T09:15:10.000Z","dependencies_parsed_at":"2025-06-11T00:49:27.805Z","dependency_job_id":null,"html_url":"https://github.com/Mastercard/loyalty-airport-reference-app","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/Mastercard/loyalty-airport-reference-app","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastercard%2Floyalty-airport-reference-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastercard%2Floyalty-airport-reference-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastercard%2Floyalty-airport-reference-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastercard%2Floyalty-airport-reference-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mastercard","download_url":"https://codeload.github.com/Mastercard/loyalty-airport-reference-app/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastercard%2Floyalty-airport-reference-app/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":271215036,"owners_count":24720097,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-19T02:00:09.176Z","response_time":63,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2025-06-11T00:38:34.742Z","updated_at":"2025-08-19T20:11:33.287Z","avatar_url":"https://github.com/Mastercard.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# loyalty-airport-client\n\nLoyalty Airport Experience API\n- API version: 1.0.0\n  - Build date: 2019-12-26T11:53:43.013-06:00[America/Chicago]\n  \nThis repository showcases a reference implementation to use Loyalty Airport services API from [Mastercard Developers](https://developer.mastercard.com).\n\nThe Loyalty Airport Lounge APIs offers cardholders, via their issuers, the ability to  access the Mastercard Airport Lounge service through this digital channel.  Cardholders can search for airport lounges, get airport lounge details,  access airport lounges via their personalized Digital Membership Card,  and access their lounge history. These APIs can be used to build a rich,  interactive airport experience within the issuer's existing mobile application.\n\n\n\n*Automatically generated by the [OpenAPI Generator](https://openapi-generator.tech)*\n\n\n## Requirements\n\nBuilding the API client library requires:\n1. Java 1.7+\n2. Maven/Gradle\n\n#### Dependencies\n1. [Mastercard client authentication library](https://github.com/Mastercard?\u0026q=oauth). [for more info](https://github.com/Mastercard/oauth1-signer-java/blob/master/README.md)\n\n\n## Getting Started\n\nPlease follow the [Steps to run the application from command line](#steps-to-run-the-application-from-command-line) to see how it works from command line.\n\n## Installation\n\nTo install the API client library to your local Maven repository, simply execute:\n\n```shell\nmvn clean install\n```\n\nTo deploy it to a remote Maven repository instead, configure the settings of the repository and execute:\n\n```shell\nmvn clean deploy\n```\n\nRefer to the [OSSRH Guide](http://central.sonatype.org/pages/ossrh-guide.html) for more information.\n\n### Maven users\n\nAdd this dependency to your project's POM:\n\n```xml\n\u003cdependency\u003e\n  \u003cgroupId\u003ecom.mastercard.developer\u003c/groupId\u003e\n  \u003cartifactId\u003eloyalty-airport-client\u003c/artifactId\u003e\n  \u003cversion\u003e1.0.0\u003c/version\u003e\n  \u003cscope\u003ecompile\u003c/scope\u003e\n\u003c/dependency\u003e\n```\n\n### Gradle users\n\nAdd this dependency to your project's build file:\n\n```groovy\ncompile \"com.mastercard.developer:loyalty-airport-client:1.0.0\"\n```\n\n### Others\n\nAt first generate the JAR by executing:\n\n```shell\nmvn clean package\n```\n\nThen manually install the following JARs:\n\n* `target/loyalty-airport-client-1.0.0.jar`\n* `target/lib/*.jar`\n\n\n## Documentation for API Endpoints\n\nAll URIs are relative to *https://api.mastercard.com*\n\nClass | Method | HTTP request | Description\n------------ | ------------- | ------------- | -------------\n*AirportApi* | [**loyaltyAirportDigitalMembershipCardsGet**](docs/AirportApi.md#loyaltyAirportDigitalMembershipCardsGet) | **GET** /loyalty/airport/digital-membership-cards | Get airport lounge digital membership card\n*AirportApi* | [**loyaltyAirportEntitlementsGet**](docs/AirportApi.md#loyaltyAirportEntitlementsGet) | **GET** /loyalty/airport/entitlements | Get information about future personal and guest entitlements\n*AirportApi* | [**loyaltyAirportLoungesGet**](docs/AirportApi.md#loyaltyAirportLoungesGet) | **GET** /loyalty/airport/lounges | Find airport lounges\n*AirportApi* | [**loyaltyAirportLoungesLoungeCodeGet**](docs/AirportApi.md#loyaltyAirportLoungesLoungeCodeGet) | **GET** /loyalty/airport/lounges/{lounge_code} | Get airport lounge details\n*AirportApi* | [**loyaltyAirportVisitsGet**](docs/AirportApi.md#loyaltyAirportVisitsGet) | **GET** /loyalty/airport/visits | Get airport lounge access history\n*BundleProfileApi* | [**createUser**](docs/BundleProfileApi.md#createUser) | **POST** /bundle/profile/users | Create Profile\n*BundleProfileApi* | [**patchUser**](docs/BundleProfileApi.md#patchUser) | **POST** /bundle/profile/users/{user_id}/patch | Partially Update Profile\n*BundleProfileApi* | [**readConsent**](docs/BundleProfileApi.md#readConsent) | **GET** /bundle/profile/users/{user_id}/products/{product}/consents | Find Consent by Id and product\n*BundleProfileApi* | [**readUser**](docs/BundleProfileApi.md#readUser) | **GET** /bundle/profile/users/{user_id} | Find User by Id\n\n\n## Documentation for Models\n\n - [Account](docs/Account.md)\n - [Address](docs/Address.md)\n - [BundleUser](docs/BundleUser.md)\n - [BundleUserData](docs/BundleUserData.md)\n - [BundleUserPatch](docs/BundleUserPatch.md)\n - [BundleUserResponse](docs/BundleUserResponse.md)\n - [BundleUserResponseData](docs/BundleUserResponseData.md)\n - [BundleUserResponseErrors](docs/BundleUserResponseErrors.md)\n - [Consent](docs/Consent.md)\n - [Email](docs/Email.md)\n - [Error](docs/Error.md)\n - [ErrorItem](docs/ErrorItem.md)\n - [ErrorItems](docs/ErrorItems.md)\n - [ErrorItemsErrors](docs/ErrorItemsErrors.md)\n - [Errors](docs/Errors.md)\n - [ErrorsErrors](docs/ErrorsErrors.md)\n - [Identification](docs/Identification.md)\n - [Im](docs/Im.md)\n - [IsRegistered](docs/IsRegistered.md)\n - [Lounge](docs/Lounge.md)\n - [LoungeAirport](docs/LoungeAirport.md)\n - [LoungeAirportImage](docs/LoungeAirportImage.md)\n - [LoungeAmenity](docs/LoungeAmenity.md)\n - [LoungeDMC](docs/LoungeDMC.md)\n - [LoungeDMCMedia](docs/LoungeDMCMedia.md)\n - [LoungeDetail](docs/LoungeDetail.md)\n - [LoungeEntitlement](docs/LoungeEntitlement.md)\n - [LoungeHistoryItem](docs/LoungeHistoryItem.md)\n - [LoungeImage](docs/LoungeImage.md)\n - [LoungeVisitEntitlement](docs/LoungeVisitEntitlement.md)\n - [Name](docs/Name.md)\n - [PatchDocument](docs/PatchDocument.md)\n - [PhoneNumber](docs/PhoneNumber.md)\n - [Photo](docs/Photo.md)\n - [User](docs/User.md)\n - [UserProduct](docs/UserProduct.md)\n - [UserProductResponse](docs/UserProductResponse.md)\n - [UserReadAccountResponse](docs/UserReadAccountResponse.md)\n\n\n## Documentation for Authorization\n\nAll endpoints do not require authorization.\nAuthentication schemes defined for the API:\n\n## Recommendation\n\nIt's recommended to create an instance of `ApiClient` per thread in a multithreaded environment to avoid any potential issues.\n\n## Author\n\nloyalty-benefits-support@mastercard.flowdock.com\n\n# Steps to run the application from command line\n              \n- Create a new project from Mastercard DevZone - stage.developer.mastercard.com or developer.mastercard.com\n- Select \"Loyalty Airport\" from Choose API dropdown and hit continue.\n- Get Sandbox keys and store your .p12 certificate along with the readme/documentation.\n- Please save this Sandbox Keys, .p12, key store password and alias as you are going to use these to run the application.\n- Clone this repository and set up as Maven project\n- Update the following keys in application.properties file\n    - *mastercard.airport.ref.app.consumer.key*: This can be found in the project you created on developerZone\n    - *mastercard.airport.ref.app.keystore.path*: Path where you saved your certs i.e., .p12 file you received while creating a project\n    - *mastercard.airport.ref.app.keystore.password*: This is the password you get with Sandbox cert.\n    - *mastercard.airport.ref.app.keystore.alias*: This is the alias you get with Sandbox cert.\n    \n- Example:\n    - mastercard.airport.ref.app.url = https://stage.api.mastercard.com\n    - mastercard.airport.ref.app.consumer.key = Abcdfefgjhilklmnopqrstuvwxyz-dxcq_zD7IiPa0df175e!22a7fddba56e800000000000000000\n    - mastercard.airport.ref.app.keystore.path = C:\\\\path\\\\provided.p12\n    - mastercard.airport.ref.app.keystore.password = pwd\n    - mastercard.airport.ref.app.keystore.alias = alias\n\n\t\n- Do a clean build either through IDE or command prompt, if you are doing it through command prompt then the below command should be executed in the directory which contains this repository's pom file\n    Eg: mvn clean install\n- Run the application using below command \n    - Eg: `java -jar path of the Jar relative to the current directory/loyalty-airport-client-1.0.0.jar \u003cargument\u003e`\n    - Argument: An argument which defines the feature user wants to run through command line. If you don't specify this argument, it will run all the features(registration,lounges,loungeDetails,dmc,entitlement and loungeHistory, error) one after the other\n        - registration : Registration for airport service\n        - lounges : Find airport lounges\n        - loungeDetails : Get airport lounge details\n        - dmc : Get the digital membership card to access the lounge\n        - entitlement : Get information about future personal and guest entitlements\n        - loungeHistory: Get airport lounge access history \n        - error: An error scenario example         \n               \n- Command line example to run the application: \n    - `java -jar target/loyalty-airport-client-1.0.0.jar dmc` here the application runs only dmc feature. if you want to run more than one feature then specify the features with comma separated. Eg: `java -jar target/loyalty-airport-client-1.0.0.jar dmc,registration,error` here it executes only these 3 features.You can remove the argument to run all the features Eg: `java -jar target/loyalty-airport-client-1.0.0.jar`. If you want to run the feature one by one then execute the command `java -jar target/loyalty-airport-client-1.0.0.jar dmc` then again run the command with different feature `java -jar target/loyalty-airport-client-1.0.0.jar lounges` and so on.\n    \n# Sandbox Testing\n    \nIf you would like to test this in Sandbox environment please contact Mastercard representative to set up you or your organization in this environment because if this does not happen the authorization fails in the Loyalty Airport Service API. All the URLs have a prefix `reference` in this reference application for all resources of Loyalty Airport Service API so that it deals with sample data. You need to remove this `reference` word from the URLs when testing against real data. Eg: `/loyalty/airport/reference` just for reference application and `/loyalty/airport` to test against real data. \n\nWhile testing the application with a `reference(/loyalty/airport/reference)` url you need to send the exact inputs that are used in this reference app to get the desired response otherwise the mock returns an error with a message 'the request does not match'.\n\n\n    \n \nFind the [service documentation](https://developer.mastercard.com/documentation/loyalty-airport) for more information. \n\nClient libraries can be generated for a simplified integration with the reference service, [for more details](https://developer.mastercard.com/blog/consuming-mastercard-apis-in-client-applications)\n\n\nCopyright (c) 2019 Mastercard\n \nLicensed under the Apache License, Version 2.0 (the \"License\");\nyou may not use this file except in compliance with the License.\nYou may obtain a copy of the License at\n \n    http://www.apache.org/licenses/LICENSE-2.0\n \nUnless required by applicable law or agreed to in writing, software\ndistributed under the License is distributed on an \"AS IS\" BASIS,\nWITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\nSee the License for the specific language governing permissions and\nlimitations under the License.    \n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmastercard%2Floyalty-airport-reference-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmastercard%2Floyalty-airport-reference-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmastercard%2Floyalty-airport-reference-app/lists"}