> 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/alternative-payment-modules-apm/commerce-sdk-and-apm-getting-started.md). # 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. {% columns %} {% column %}

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

{% endcolumn %} {% column %}

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


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

{% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endstep %} {% step %} ### Create your First Project Open Android Studio and select **Start a new Verifone project**. {% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endstep %} {% step %} ### Run your App in the Simulator Create and run a simulator configuration for your app. Choose a trigger and a display resolution. {% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endstep %} {% step %} ### Test on Hardware Export a test package, then install it on a Developer Kit. {% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% 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.

{% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endstep %} {% step %} ### Need help? Use the troubleshooting guide to fix common installation, simulator, and environment issues. {% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% 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 %} {% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} ### 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.

{% columns %} {% column %} {% endcolumn %} {% column %}

{% endcolumn %} {% endcolumns %} {% endstep %} {% endstepper %} --- # 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 by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.verifone.com/alternative-payment-modules-apm/commerce-sdk-and-apm-getting-started.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. 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.