# Reference Application
source: https://developer.mastercard.com/mastercard-agent-pay/documentation/reference-app/index.md

👉 Copy this default information about Reference Applications and outline the pre-requisites required for using the Reference Application.

The reference application is a simple Spring Boot Application that shows a typical usage of the {Pet Store} API and how to integrate different operations in the Sandbox environment. You can either re-use or take code references for your implementation.
>
> #### What you will learn: {#what-you-will-learn}
>
> * How to use the reference application?
> * How to configure your application for the Sandbox and the Production environments?
> * How to test your reference application?

## Pre-requisites {#pre-requisites}

👉 Explain the Pre-requisites required for the Reference Application.

* Java 17 and above installed.

## Technologies Used {#technologies-used}

👉 Explain the technologies used and anything the developer will need to build the supplied reference app.

* [Spring Boot](https://spring.io/projects/spring-boot)
* [Apache Maven](https://maven.apache.org/)
* [OpenAPI Generator 7.9.x](https://openapi-generator.tech/)

## Get the Source Code {#get-the-source-code}

👉 Link to our public {Pet Store} Spring Boot Reference App project in GitHub. If you want to host your own reference application on GitHub see our documentation [here](https://stage.developer.mastercard.com/jamstack/documentation/content-guide/referenceapp-guide/#requirements).

👉 Use the following table if you want to include a GitHub badge.

Config.toml

```markdown
[params]
wikiJavaGitHubBadge = "https://img.shields.io/github/stars/Mastercard/petstore-application-java.svg?label=/java&style=social"
wikiJavaGitHubLink = "https://github.com/Mastercard/petstore-application-java"
```

Java SVG

```svg
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<svg width="29px" height="39px" viewBox="0 0 29 39" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
  <!-- Generator: Sketch 3.8.3 (29802) - http://www.bohemiancoding.com/sketch -->
  <title>language-java</title>
  <desc>Created with Sketch.</desc>
  <defs></defs>
  <g id="Page-1" stroke="none" stroke-width="1" fill="none" fill-rule="evenodd">
    <g id="language-java">
      <path d="M9.07052632,30.3231579 C9.07052632,30.3231579 7.61368421,31.1705263 10.1073684,31.4568421 C13.1284211,31.8010526 14.6726316,31.7515789 18.0021053,31.1221053 C18.0021053,31.1221053 18.8789474,31.6715789 20.1010526,32.1463158 C12.6357895,35.3463158 3.20631579,31.9610526 9.06947368,30.3221053 M8.15789474,26.1494737 C8.15789474,26.1494737 6.52315789,27.36 9.02105263,27.6168421 C12.2473684,27.9494737 14.7968421,27.9768421 19.2073684,27.1273684 C19.2073684,27.1273684 19.8178947,27.7484211 20.7757895,28.0852632 C11.7515789,30.7242105 1.7,28.2936842 8.15789474,26.1505263" id="Shape" fill="#999999"></path>
      <path d="M25.7189474,33.4105263 C25.7189474,33.4105263 26.7968421,34.3 24.5315789,34.9873684 C20.2231579,36.2926316 6.59894737,36.6863158 2.81578947,35.04 C1.45473684,34.4473684 4.00526316,33.6252632 4.80842105,33.4536842 C5.64526316,33.2747368 6.12421053,33.3063158 6.12421053,33.3063158 C4.61052632,32.2410526 -3.65473684,35.4010526 1.92421053,36.3063158 C17.1431579,38.7726316 29.6673684,35.1926316 25.7189474,33.4115789 M9.77052632,21.8242105 C9.77052632,21.8242105 2.84105263,23.4705263 7.31789474,24.0684211 C9.20631579,24.3210526 12.9736842,24.2642105 16.4831579,23.9705263 C19.3505263,23.7284211 22.2305263,23.2126316 22.2305263,23.2126316 C22.2305263,23.2126316 21.2178947,23.6463158 20.4863158,24.1463158 C13.4494737,25.9957895 -0.145263158,25.1357895 3.76842105,23.2410526 C7.08,21.6410526 9.77052632,21.8231579 9.77052632,21.8231579 M22.2021053,28.7726316 C29.3557895,25.0568421 26.0484211,21.4831579 23.7389474,21.9642105 C23.1736842,22.0821053 22.9221053,22.1852632 22.9221053,22.1852632 C22.9221053,22.1852632 23.1326316,21.8547368 23.5326316,21.7115789 C28.1010526,20.1073684 31.6136842,26.4484211 22.0589474,28.96 C22.0589474,28.96 22.1694737,28.8610526 22.2021053,28.7726316" id="Shape" fill="#999999"></path>
      <path d="M10.4736842,38.8452632 C17.34,39.2852632 27.8842105,38.6010526 28.1347368,35.3526316 C28.1347368,35.3526316 27.6547368,36.5842105 22.4610526,37.5631579 C16.5978947,38.6652632 9.37052632,38.5368421 5.08210526,37.8294737 C5.08210526,37.8294737 5.96105263,38.5557895 10.4736842,38.8452632" id="Shape" fill="#999999"></path>
      <path d="M15.8473684,19.0673684 C17.6863158,21.1852632 15.3631579,23.0905263 15.3631579,23.0905263 C15.3631579,23.0905263 20.0347368,20.68 17.8894737,17.6610526 C15.8863158,14.8452632 14.3505263,13.4473684 22.6663158,8.62421053 C22.6663158,8.62421053 9.61368421,11.8842105 15.8473684,19.0663158" id="Path" fill="#999999"></path>
      <path d="M17.8894737,0.835789474 C17.8894737,0.835789474 21.8515789,4.79894737 14.1315789,10.8926316 C7.94210526,15.7810526 12.7210526,18.5684211 14.1294737,21.7536842 C10.5157895,18.4936842 7.86421053,15.6242105 9.64315789,12.9536842 C12.2557895,9.03263158 19.4884211,7.13263158 17.8905263,0.835789474" id="Path" fill="#999999"></path>
    </g>
  </g>
</svg>
```

reference-app.md

```markdown
|         |                        ![Java](/uploads/java.svg)                          |
|:-------:|:--------------------------------------------------------------------------:|
| **View on GitHub** | [![](https://img.shields.io/github/stars/Mastercard/petstore-application-java.svg?label=/java&amp;style=social)](https://github.com/Mastercard/petstore-application-java) |
```

<br />

|                    |                                    ![Java](https://static.developer.mastercard.com/content/mastercard-agent-pay/uploads/java.svg)                                     |
|--------------------|-----------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| **View on GitHub** | [![](https://img.shields.io/github/stars/Mastercard/petstore-application-java.svg?label=/java&style=social)](https://github.com/Mastercard/petstore-application-java) |

* Clone the [{Pet Store} Reference App](https://github.com/Mastercard/petstore-application-java) from GitHub and open it in your IDE.
* In the root directory of the application, follow the **README.md** file to configure and run the application.