> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/psdk-latest/psdk-downloads-and-class-intro/reference_applications.md).

# Reference Applications

{% hint style="danger" %}
**Warning:** These applications and their code are not intended for use in field deployment, they are only intended to provide some additional understanding for developers using the library.
{% endhint %}

***

## Android <a href="#id2" id="id2"></a>

{% @verifone-s3/s3-list-files prefix="dwn/dev/psdk/ref-apps/android" %}

To run the reference project:

1. Extract the zip file
2. Copy the PaymentSdk AAR file into the app/libs folder
3. Launch Android Studio
4. Either select “Open an existing Android Studio project” from the splash screen or select “Open” from the File menu
5. Select the extracted AndroidReferenceApp folder
6. Make sure the JDK location is pointing to Java 1.8.

***

## iOS <a href="#id3" id="id3"></a>

{% @verifone-s3/s3-list-files prefix="dwn/dev/psdk/ref-apps/ios" %}

To run the reference project:

1. Extract the zip file
2. Copy the PaymentSdk.xcframework file into the PSDKReferenceApp folder
3. Launch XCode
4. Click on the TARGETS and select PSDKReferenceApp
5. In the section “Frameworks, Libraries, and Embedded Content” select \[+] sign to add a framework
6. A popup will open, from the “Add Other” dropdown select “Add Files”
7. Select the PaymentSdk.xcframework from the PSDKReferenceApp folder
8. Make sure the framework is configured for “Embed & Sign”
9. Update the “Signing & Capabilities” with your “Team”, “Provisioning Profile”, and “Signing Certificate”
10. Run the app

***

## Linux <a href="#id4" id="id4"></a>

{% @verifone-s3/s3-list-files prefix="dwn/dev/psdk/ref-apps/linux" %}

To run the reference project:

1. Extract the PSDK library to a separate directory saving the full path to PSDK\_PATH environment variable
2. Extract the Linux reference application and change to resulting directory
3. Create a directory for building and change to this directory
4. In terminal run: `cmake -DPSDK_PATH=\$PSDK_PATH ..`
5. In terminal run: `cmake --build .`
6. Run psdk\_reference\_app executable

***

## Windows Win32 <a href="#id5" id="id5"></a>

{% @verifone-s3/s3-list-files prefix="dwn/dev/psdk/ref-apps/windows" %}

To run the reference project:

1. Extract the PSDK library to a separate directory saving the full path to PSDK\_PATH environment variable
2. Extract the Windows reference application and change to resulting directory
3. Create a directory for building and change to this directory
4. Run using Command Prompt: `cmake -DPSDK_PATH=%PSDK_PATH% ..`
5. Run using Command Prompt: `cmake --build .`
6. Run using Command Prompt: `cd Debug`
7. Run psdk\_reference\_app executable

***

## Windows Dot Net <a href="#id6" id="id6"></a>

{% @verifone-s3/s3-list-files prefix="dwn/dev/psdk/ref-apps/.net" %}

To run the reference project:

1. Extract the application, and open the DotNetReferenceApp.sln using visual studio.
2. Inside Solution Explorer, in project DotNetReferenceApp.sln, right click “References”, then add VerifoneSdk dll into a separate lib folder.
3. Deploy on local machine with green start menu.

***

## Java <a href="#id7" id="id7"></a>

{% @verifone-s3/s3-list-files prefix="dwn/dev/psdk/ref-apps/java" %}

To run the reference project:

1. Extract the zip file.
2. Copy the PSDK library PaymentSdk-xxx.jar to app/libs.
3. Build the app: ./gradlew build.
4. Execute the jar file: “java -jar app/build/libs/app.jar”.

## Commerce Trigger Demo App

{% @verifone-s3/s3-list-files prefix="dwn/dev/psdk/ref-apps/commerce-t" %}

To run the demo project:

1. Extract the zip file
2. Launch Android Studio
3. Either select “Open an existing Android Studio project” from the splash screen or select “Open” from the File menu
4. Select the extracted *DemoPSDKTrigger* folder.

## Commerce Donation Reference App

{% @verifone-s3/s3-list-files prefix="dwn/dev/psdk/ref-apps/commerce-d" %}

To run the demo project:

1. Extract the zip file
2. Launch Android Studio
3. Either select “Open an existing Android Studio project” from the splash screen or select “Open” from the File menu
4. Select the extracted *donationcpdemoapp* folder.

***

{% columns %}
{% column width="25%" %}

<figure><img src="/files/9ezXRridnCaI1awLr3X9" alt="" width="150"><figcaption></figcaption></figure>
{% endcolumn %}

{% column width="25%" %}

{% endcolumn %}

{% column width="16.66666666666666%" %}
**Version:**\
**Date:**
{% endcolumn %}

{% column width="33.333333333333336%" %} <code class="expression">space.vars.psdk\_version</code>\ <code class="expression">space.vars.psdk\_date</code>
{% endcolumn %}
{% endcolumns %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.verifone.com/psdk-latest/psdk-downloads-and-class-intro/reference_applications.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.