# GPA Getting started

**Global Payment Application (GPA)** is a standard payment solution for **Engage** platform. It delivers a consistent cross-device experience and supports regional and local customization through a plug-and-play model.

{% 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 %}

### What you will find in this space

* End-user and operator guides for GPA devices.
* Integration guides for NEXO and semi-integrated deployments.
* Technical reference for payment features, configuration, operations, and security.
* Developer toolkits for POS and host module.
* Installation, migration, download, and support material.

### Quick Start

{% stepper %}
{% step %}

### Unlocking GPA

Start here to understand what GPA is and how the solution is structured.

These pages explain the core application model and the main design patterns used across deployments.

{% 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 %}

{% if visitor.isSet === true %} <a href="/spaces/JQkY7HQfm8TbTXU9l4th/pages/1vNt9zxVlqvezftGljof" class="button primary" data-icon="cash-register">GPA Overview</a><a href="/spaces/JQkY7HQfm8TbTXU9l4th/pages/StOfeq5SQqOSru0Vg8nc" class="button secondary" data-icon="sitemap">Solution Design Patterns</a>
{% endif %}
{% endstep %}

{% step %}

### GPA Downloads

Download the latest GPA package and explore the release notes to see what’s new.

{% 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 %}

{% if visitor.isSet === true %} <a href="/spaces/JQkY7HQfm8TbTXU9l4th/pages/TN3hyFgwdqNuiDPlNlMq" class="button primary" data-icon="desktop-arrow-down">GPA Downloads and Release Notes</a>
{% endif %}
{% endstep %}

{% step %}

### Application Loading

Load GPA onto the terminal before setup begins using IDS or SYSMODE.

{% 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 %}

{% if visitor.isSet === true %} <a href="/spaces/JQkY7HQfm8TbTXU9l4th/pages/Zd3v6hCmZuoGW6MqIEdj" class="button primary" data-icon="bars-progress">Application Loading</a>
{% endif %}
{% endstep %}

{% step %}

### Terminal Setup

Complete terminal setup after the application is loaded.

{% tabs %}
{% tab title="Warehouse Install" %}
This path will guide a **warehouse engineer** through the GPA installation process, in order to prepare the terminal for the merchant.

{% 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 %}

{% if visitor.isSet === true %} <a href="/spaces/JQkY7HQfm8TbTXU9l4th/pages/pgmFlhbcbOT10yTzKIT3" class="button primary" data-icon="warehouse">Warehouse Install Guide</a>
{% endif %}
{% endtab %}

{% tab title="Self Install" %}
This path fits on-site terminal setup where the device is configured during installation.

{% 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 %}

{% if visitor.isSet === true %} <a href="/spaces/JQkY7HQfm8TbTXU9l4th/pages/H9exDBW0aaNyDXRRLydl" class="button primary" data-icon="head-side-gear">Self Installation Guide</a>
{% endif %}
{% endtab %}
{% endtabs %}
{% endstep %}
{% endstepper %}

### Define your Next Step

{% stepper %}
{% step %}

### Integrate with an ECR or POS

Start here for semi-integrated payments and NEXO message flows.

{% 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 %}

{% if visitor.isSet === true %} <a href="/spaces/JQkY7HQfm8TbTXU9l4th/pages/TYpBpUKhBCQcESClVM2P" class="button primary" data-icon="cash-register">Nexo ECR Guide</a><a href="/spaces/JQkY7HQfm8TbTXU9l4th/pages/BafExI3jQzPbp5aaeUtE" class="button secondary" data-icon="presentation-screen">GPA Semi-Integrated Solution</a>
{% endif %}
{% endstep %}

{% step %}

### Build or Customize GPA

Start here for architecture, behavior, data models, and toolkit flows.

{% if visitor.isSet === true %}

<table data-column-title-hidden data-view="cards"><thead><tr><th>Guide</th><th data-card-target data-type="content-ref">Open</th><th data-hidden data-card-cover data-type="image">Cover image</th><th data-hidden></th></tr></thead><tbody><tr><td>📘 Features, rules, and security.</td><td><a href="/spaces/JQkY7HQfm8TbTXU9l4th/pages/2PIIGVla76WziGbUxRi6">/spaces/JQkY7HQfm8TbTXU9l4th/pages/2PIIGVla76WziGbUxRi6</a></td><td><a href="/files/RPn80hhNY45KRpZXDInE">/files/RPn80hhNY45KRpZXDInE</a></td><td></td></tr><tr><td>🧰 POS architecture, flows, and development.</td><td><a href="/spaces/JQkY7HQfm8TbTXU9l4th/pages/yLtFuY7XEtoy8x50tRcy">/spaces/JQkY7HQfm8TbTXU9l4th/pages/yLtFuY7XEtoy8x50tRcy</a></td><td><a href="/files/RVNEQlybzunlxPIWd7NN">/files/RVNEQlybzunlxPIWd7NN</a></td><td></td></tr><tr><td>⚙️ Host architecture, communications, and transactions.</td><td><a href="/spaces/JQkY7HQfm8TbTXU9l4th/pages/1mmaLfj67t3c0cLwIBOU">/spaces/JQkY7HQfm8TbTXU9l4th/pages/1mmaLfj67t3c0cLwIBOU</a></td><td><a href="/files/6Oy9ZINXPhqBLBzbSIxN">/files/6Oy9ZINXPhqBLBzbSIxN</a></td><td></td></tr></tbody></table>
{% endif %}
{% endstep %}

{% step %}

### Migrate GPA

Start here to plan and execute a version upgrade.

{% 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 %}

{% if visitor.isSet === true %} <a href="/spaces/JQkY7HQfm8TbTXU9l4th/pages/8jaFeyuQVVm62xzoRgqG" class="button primary" data-icon="up-right-from-square">Migration Guides 1.3 to 2.6</a>
{% endif %}
{% endstep %}

{% step %}

### Troubleshoot and Support

{% 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 %}

Start here to diagnose issues in the field and resolve common support tasks.

{% if visitor.isSet === true %} <a href="/spaces/JQkY7HQfm8TbTXU9l4th/pages/8Dx7kE2AGQbbQXB223g1" class="button primary" data-icon="screwdriver-wrench">Troubleshooting and Support Guide</a>
{% endif %}
{% endstep %}
{% endstepper %}

{% if visitor.isSet === true %}

### Further Reading

* [User Guide](broken://spaces/JQkY7HQfm8TbTXU9l4th/pages/Llo1VMQwrhBcSIOVNm5j) for payment flows, device behavior, and operator tasks.
* [SDI Client](broken://spaces/JQkY7HQfm8TbTXU9l4th/pages/jD442nnQuOjCmk5mSwPl) for client integration, card APIs, and EMV configuration.
* [Setting Connection](broken://spaces/JQkY7HQfm8TbTXU9l4th/pages/4z7NYJ7dvsUPgwBHreYe) for transport and network setup options.
  {% endif %}


---

# 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/gpa/gpa-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.
