# Verifone Tap Getting Started

Start here to choose the fastest path into Verifone Tap.

{% if visitor.isSet === false %}
{% columns %}
{% column %}

<h4 align="center"><strong>Please login or register to gain access to the detailed material on this page.</strong></h4>
{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a><a href="https://partner-registration.verifone.com/" class="button secondary">Register for an Account</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}

{% hint style="info" %}
Choose the path that matches your goal:

* Explore Verifone Tap with the demo app — Evaluate the experience without building or integrating any Sdk.
* Build and run the Verifone Tap reference app — Build the sample app source provided instead of integrating into your own app.
* Integrate Verifone Tap SDK into your app — Add the SDK to your own codebase and build your own payment flow
  {% endhint %}

{% tabs %}
{% tab title="Explore with demo app" %}
{% hint style="info" %}

* Use this path if you want to explore Verifone Tap before you integrate it.
* You do not need to build or integrate anything.
  {% endhint %}

{% stepper %}
{% step %}

### Get the demo app

<table data-header-hidden><thead><tr><th width="380.22222900390625" valign="top"></th><th align="center" valign="top"></th></tr></thead><tbody><tr><td valign="top"><p>Download the demo app for Android or iOS.</p><p>With prebuilt demo apps, you can validate the flow before starting integration.</p></td><td align="center" valign="top"><img src="/files/9OPVxPFUKv4M1vNB6oyL" alt="" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/9xF7UhXZ5DiTVC44vfjE" class="button primary" data-icon="desktop-arrow-down">Download demo applications</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Get a test QR code

Contact Verifone Support to request a QR code for device activation.

{% if visitor.isSet === true %} <a href="https://verifone.atlassian.net/servicedesk/customer/portal/300" class="button primary" data-icon="tickets">Contact support for QR for activation</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Test the app

1. Install the app.
2. During initialization, use the QR code to activate the device.
3. Then run a test payment.
4. For iPhone testing, sign in with an Apple sandbox tester account. The sandbox tester email address must never have been used as an Apple Account.

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/9vNVtlbLJEnFp5FA7mMm" class="button primary" data-icon="mobile-screen-button">Review SDK activation</a><a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/MMrBssKzYaR46dQXjUVS#testing-tap-to-pay-on-iphone-sandbox" class="button secondary" data-icon="apple">Prepare iPhone sandbox testing</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Build and run reference app" %}
{% hint style="info" %}

* Use this path if you want to build and run the Verifone Tap reference app.
* You work from the sample app source.
* You do not add the SDK to your own app yet.
  {% endhint %}

{% stepper %}
{% step %}

### Download the reference app

<table data-header-hidden><thead><tr><th width="380.22222900390625" valign="top"></th><th align="center"></th></tr></thead><tbody><tr><td valign="top"><p>Open the release page you want to use. Each release page includes the reference app downloads. Choose the release you want to build and use its packaged reference app files.</p><p></p></td><td align="center"><img src="/files/9OPVxPFUKv4M1vNB6oyL" alt="" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/oYJZigoqVew9T2GYIG4g" class="button primary" data-icon="desktop-arrow-down">Open SDK downloads</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Get a test QR code

Contact Verifone Support to request a QR code for device activation.

{% if visitor.isSet === true %} <a href="https://verifone.atlassian.net/servicedesk/customer/portal/300" class="button primary" data-icon="tickets">Contact support for QR for activation</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Build the app

<table data-header-hidden><thead><tr><th width="380.22222900390625" valign="top"></th><th align="center"></th></tr></thead><tbody><tr><td valign="top"><p>Use the platform setup guides to build the app locally.</p><p>Each setup guide includes a short note for building the existing reference app.</p><p></p></td><td align="center"><img src="/files/taE0fcBp2sxeiD77V2OC" alt="" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/JZ5HLbppnDLQ77jnfhi8" class="button primary" data-icon="android">Open Android setup guide</a><a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/MMrBssKzYaR46dQXjUVS" class="button secondary" data-icon="apple">Open iOS setup guide</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Onboard the Android app

The Android reference app must still be onboarded before testing.

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/ZpMpktaR3m8Gp9jyVJ0w" class="button primary" data-icon="cloud-arrow-up">Android application onboarding</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Prepare Apple sandbox testing

For iPhone testing, sign in with an Apple sandbox tester account. The sandbox tester email address must never have been used as an Apple Account.

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/MMrBssKzYaR46dQXjUVS#testing-tap-to-pay-on-iphone-sandbox" class="button primary" data-icon="apple">Prepare iPhone sandbox testing</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Test the app

1. Install the app.
2. During initialization, use the QR code to activate the device.
3. Then run a test payment.

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/9vNVtlbLJEnFp5FA7mMm" class="button primary" data-icon="mobile-screen-button">Review SDK activation</a><a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/08TZe1D4qNHNQu8n9uGD" class="button secondary" data-icon="basket-shopping">Run a sale test</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}
{% endstepper %}
{% endtab %}

{% tab title="Integrate Verifone Tap SDK" %}
{% hint style="info" %}

* Use this path if you want to integrate Verifone Tap SDK into your app.
* You add the SDK to your own project.
* You configure your app, payment flow, and deployment.
* Use this path for a real integration.
* Use the other paths only for evaluation or sample-app setup.
  {% endhint %}

{% stepper %}
{% step %}

### Prepare merchant and terminal setup

<table data-header-hidden><thead><tr><th width="380.22216796875" valign="top"></th><th align="center"></th></tr></thead><tbody><tr><td valign="top"><p>Complete onboarding to set up the merchant and terminal.</p><p>If onboarding is still in progress, request a temporary QR code from Verifone Support.</p></td><td align="center"><img src="/files/BLc8Te6GgBgiK5V0tWCb" alt="" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/fzNVgWMulWMVYPiV2z7y" class="button primary" data-icon="ticket-airline">Review merchant onboarding</a><a href="https://verifone.atlassian.net/servicedesk/customer/portal/300" class="button secondary" data-icon="tickets">Contact support for QR for activation</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Download the Verifone Tap SDK

<table data-header-hidden><thead><tr><th width="382.888916015625" valign="top"></th><th align="center"></th></tr></thead><tbody><tr><td valign="top"><p>Download the latest SDK for Android or iOS.</p><p>With copy-and-paste-ready examples and quick authentication, you can get started fast.</p><p></p></td><td align="center"><img src="/files/9OPVxPFUKv4M1vNB6oyL" alt="" data-size="original"></td></tr></tbody></table>

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/oYJZigoqVew9T2GYIG4g" class="button primary" data-icon="down-to-bracket">Get the Verifone Tap SDK</a>
{% endif %}
{% endstep %}

{% step %}

### Follow the development guide

Choose your platform and complete the setup steps.

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/JZ5HLbppnDLQ77jnfhi8" class="button primary" data-icon="android">Android development setup</a><a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/MMrBssKzYaR46dQXjUVS" class="button secondary" data-icon="apple">iOS development setup</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Review the Payment API

Use the Payment API to initialize the SDK and run payment flows.

Setting up your first API call should be the easiest part of getting started.

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/ptDcz4w9aYYS4WHKsoM6" class="button primary" data-icon="gear-complex-api">View the Payment API</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Onboard the Android app

{% hint style="warning" %}
This step applies to Android only.
{% endhint %}

Upload your integrated Android app to the secure onboarding platform. iOS does not require application onboarding. Enable the Tap to Pay entitlement during iOS setup instead.

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/ZpMpktaR3m8Gp9jyVJ0w" class="button primary" data-icon="cloud-arrow-up">Android application onboarding</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Prepare Apple sandbox testing

For iPhone testing, sign in with an Apple sandbox tester account. The sandbox tester email address must never have been used as an Apple Account.

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/MMrBssKzYaR46dQXjUVS#testing-tap-to-pay-on-iphone-sandbox" class="button primary" data-icon="apple">Prepare iPhone sandbox testing</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Test the app

Activate the app on the test device and run end-to-end payment tests.

{% if visitor.isSet === true %} <a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/9vNVtlbLJEnFp5FA7mMm" class="button primary" data-icon="mobile-screen-button">Review SDK activation</a><a href="/spaces/o2oIOVkgtD0MuTmlOHEa/pages/08TZe1D4qNHNQu8n9uGD" class="button secondary" data-icon="basket-shopping">Run a sale test</a>
{% endif %}

{% if visitor.isSet === false %}
{% columns %}
{% column %}

{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}
{% endstep %}

{% step %}

### Deploy your app

Deploy through your MDM solution, the App Store, or Google Play. After installation on the merchant device, complete activation and start taking payments.
{% endstep %}
{% endstepper %}
{% endtab %}
{% endtabs %}


---

# Agent Instructions: 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:

```
GET https://docs.verifone.com/verifone-tap/verifone-tap-getting-started.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.