# Commerce SDK & APM Getting Started Commerce Applications run on Verifone payment terminals. They extend the payment flow with custom screens, business logic, and integrations. Use them for loyalty, coupons, surveys, receipt content, and APMs. {% if visitor.isSet === false %} {% columns %} {% column %}

Please login or register to gain access to the detailed material on this page.

{% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endif %}

Learn more about what Commerce Applications can do

Commerce Applications add value without replacing the payment app. * **Launch at the right time.** Start during payment, from the desktop, or in idle mode. * **Build guided terminal flows.** Show custom screens, collect input, and move between pages. * **Connect to external services.** Send approved HTTP requests to merchant or partner systems. * **Work with payment features.** Return trigger responses, request services, print, and pass data to POS. * **Support real use cases.** Add loyalty, coupons, surveys, receipt content, analytics, and alternate payments. * **Run with or without UI.** Build interactive apps or headless services for background tasks. For more detail, see [Architecture](broken://spaces/11HigXrNYxDX41X2E4Fz/pages/4rupA52r8zEeI2c8tT3E), and [Application Lifecycle](broken://spaces/11HigXrNYxDX41X2E4Fz/pages/YsOiGVwR76zhTCFoVVM2).

{% stepper %} {% step %} ### Install the SDK


Download the Commerce Applications SDK plugin, install and configure it in your IDE.

Download the Commerce Applications SDK plugin, install and configure it in your IDE.

{% if visitor.isSet === true %} Download Commerce App SDK Plugin Installation Instructions for Windows & Mac {% endif %} {% if visitor.isSet === false %} {% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endif %} {% endstep %} {% step %} ### Create your First Project Open Android Studio and select **Start a new Verifone project**. {% if visitor.isSet === true %} Create your First Application {% endif %} {% if visitor.isSet === false %} {% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endif %} {% endstep %} {% step %} ### Run your App in the Simulator Create and run a simulator configuration for your app. Choose a trigger and a display resolution. {% if visitor.isSet === true %} Application Simulation {% endif %} {% if visitor.isSet === false %} {% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endif %} {% endstep %} {% step %} ### Test on Hardware Export a test package, then install it on a Developer Kit. {% if visitor.isSet === true %} Test Terminal and App Testing {% if visitor.isSet === false %} {% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endif %} {% endif %} {% endstep %} {% step %} ### Development Guides


Plan your test setup, then explore the core development guides. Use the tools, development, and API docs to build further.

Plan your test setup, then explore the core development guides.

Use the tools, development, and API docs to build further.

{% if visitor.isSet === true %} Developer Tools Application Development API Documentation {% endif %} {% if visitor.isSet === false %} {% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endif %} {% endstep %} {% step %} ### Need help? Use the troubleshooting guide to fix common installation, simulator, and environment issues. {% if visitor.isSet === true %} Commerce Applications SDK troubleshooting guide {% endif %} {% if visitor.isSet === false %} {% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endif %} {% endstep %} {% endstepper %} ### Advanced Payment Modules (APM) Advanced Payment Methods use QR-based payment flows on supported Verifone terminals. {% stepper %} {% step %} ### Roll out APMs


Review the APM model, onboard the merchant, and integrate the POS.

Review the APM model, onboard the merchant, and integrate the POS.

{% endstep %} {% step %} {% if visitor.isSet === true %} Advanced Payment Methods {% endif %} {% if visitor.isSet === false %} {% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endif %} ### Run APM Transactions


Test the sale flow, then confirm cancellation, refund, and settlement handling.

Test the sale flow, then confirm cancellation, refund, and settlement handling.

{% if visitor.isSet === true %} Transaction, cancellation, & refund processing {% endif %} {% if visitor.isSet === false %} {% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endif %} {% endstep %} {% endstepper %} --- # 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/alternative-payment-modules-apm/commerce-sdk-and-apm-getting-started.md?ask= ``` 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.