{"id":28577647,"url":"https://github.com/mastercard/available-merchant-offers-reference-app","last_synced_at":"2025-08-10T07:14:27.077Z","repository":{"id":39939736,"uuid":"256987981","full_name":"Mastercard/available-merchant-offers-reference-app","owner":"Mastercard","description":null,"archived":false,"fork":false,"pushed_at":"2023-03-23T15:54:32.000Z","size":125,"stargazers_count":0,"open_issues_count":3,"forks_count":3,"subscribers_count":3,"default_branch":"master","last_synced_at":"2024-04-16T10:43:11.751Z","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":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Mastercard.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-04-19T11:59:46.000Z","updated_at":"2021-12-17T09:12:51.000Z","dependencies_parsed_at":"2022-08-19T14:30:50.489Z","dependency_job_id":null,"html_url":"https://github.com/Mastercard/available-merchant-offers-reference-app","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastercard%2Favailable-merchant-offers-reference-app","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastercard%2Favailable-merchant-offers-reference-app/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastercard%2Favailable-merchant-offers-reference-app/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastercard%2Favailable-merchant-offers-reference-app/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Mastercard","download_url":"https://codeload.github.com/Mastercard/available-merchant-offers-reference-app/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Mastercard%2Favailable-merchant-offers-reference-app/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259177341,"owners_count":22817349,"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","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:47.735Z","updated_at":"2025-06-11T00:39:03.813Z","avatar_url":"https://github.com/Mastercard.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"## Available Merchant Offers Reference Implementation\n\nThis is a reference application that demonstrates how Available Merchant Offers APIs can be used. \nPlease see here for details on the APIs: [Mastercard Developers](https://developer.mastercard.com/product/avail-merchant-offers). \nThis application requires consumer key and .p12 file as received from [Mastercard Developers](https://developer.mastercard.com/dashboard).\n\n#### Setup Pre-requisites:\n\n - Maven 3.6 or later\n\n - JDK 1.8.0 or later\n\n - Spring Boot 2.2+  \n\n - A text editor or IDE\n\n#### If your IDE is IntelliJ IDEA, you may not need to download the Maven and JDK \n\n#### Checkout the code onto your local machine\n\n#### Configuration\nIf you do not want to use the default STAGE keys associated with this project. \n - Setup account at [Mastercard Developers](https://developer.mastercard.com/account/sign-up)   \n - Create a project \u0026 download signing key for the Avail Merchant Offers API. It will download a zip file.  \n - Select .p12 file and copy it to `src\\main\\resources` folder.\n - Open `${project.basedir}/src/main/resources/application.properties` and set these parameters: [consumerKey, signingKeyFilePath, keyalias, keystorepassword]. Replace 'stage' with 'sandbox' in the basepath parameter \n\n#### Build and Execute\nRunning outside of IDE, from command line\n - mvn clean install\n\n - java -jar target/AvailMerchantOffersReferenceImpl-1.0.jar\n\nGo to your browser: *localhost:8080/* and work through the application \n\nRunning on IntelliJ IDE. \n - On IntelliJ IDEA: *File/New/Project From Version Control/* \n\n - Open Maven window to generate dependencies: Click on *Lifecycle - Clean \u0026  Install*\n Compile: *Lifecycle - Compile*\n \n - Run *AvailableOffersApplication.java*\n \nThis will start up your local server at port 8080 \n\nGo to your browser: *localhost:8080/* and work through the application \n\n#### Some insights while using the service\n - Could not run this service on Sandbox as the service is not configured properly in Sandbox. Works from STAGE though, however STAGE is not stable all the time\n  \n - It returns a null pointer exception where no offers are found\n \n - Does not follow proper MC Error handling standards \n \n - Offers API has Category Code as optional but it looks to be a mandatory\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmastercard%2Favailable-merchant-offers-reference-app","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmastercard%2Favailable-merchant-offers-reference-app","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmastercard%2Favailable-merchant-offers-reference-app/lists"}