App2App Overview

Welcome to the App2App documentation, Getnet's integration solution for Android terminals. This technology ensures a seamless, secure, and efficient way to process payments directly on Getnet hardware.

App2App eliminates the need for complex cloud-to-cloud integrations for present-card transactions by allowing your software to communicate locally with the Getnet payment app installed on the same device.

Once the payment process is finished, including card reading, PIN entry, and authorization, the Getnet app automatically returns control and transaction metadata to your application.

Key Advantages and Benefits

Integrating your software with the Getnet payment app through the App2App model offers several strategic and technical advantages designed to optimize the payment journey for both the merchant and the developer. By leveraging local communication, the integration ensures a high level of security and operational efficiency.

• The software transitions fluidly to the payment interface, removing the need for operators to switch between applications manually.

• All critical processing occurs within Getnet's secure environment, ensuring your application never handles sensitive card data.

• Transactions are significantly faster because local communication between apps eliminates reliance on internet latency for internal data exchange.

• Automatic value integration eliminates manual entry mistakes and ensures total accuracy during the checkout process.

• You can either utilize the terminal's built-in printer via the Getnet app or receive raw data to generate your own customized receipts.

How it Works

The App2App integration model facilitates seamless communication between two separate Android applications using Intents. This mechanism allows your software to trigger specific payment commands within the Getnet payment app by encapsulating them in predefined request objects.

• Request: Your app sends an Android Intent to a specific URI (e.g., getnet://payment/v1/payment) containing the transaction data.
• Processing: The Getnet app processes the command and handles the communication with acquirer servers to complete the transaction securely.
• Response: The Getnet app returns a structured response to your application containing the transaction status and receipt details.

Screen Automation

One of the primary advantages of the App2App model is the ability to streamline the user interface on the POS. Depending on the parameters your application sends in the request, the Getnet app can automatically skip specific input screens.

For example, if you include a transaction amount or payment method in your deeplink, the terminal bypasses those manual entry steps and proceeds directly to the next phase of the flow. However, if required parameters are missing, the app defaults to manual entry screens to complete the data.

Next Steps

To begin your integration journey, follow the path below:

• Read Architecture & Flow to gain a deep understanding of local communication via Android Intents and how to manage the app lifecycle.

• Perform a Connectivity Check (Polling) to execute the initial "handshake" and ensure the payment service is ready before starting a sale.

• Follow the Quick Start Guide to process your first test transaction (SALE) in minutes using our provided code examples.