Skip to main content

Tap to Phone

The Tap On Phone with PIN Application(ToPP) enables your application to accept contactless payments using the merchant phone as a card reader.

In order for your app to be able to make a contactless transaction, you need to have the Tap On Phone app installed on your device. This app will be launched using an invocation SDK.

Requirements​

For the ToPP Application to work, there are some requirements that have to be met. The app will only be able to process a transaction if all of the following conditions are meet:

  • The device run Android 10 or later
  • The device supports Google Services
  • The device has NFC capabilities
  • The device is not an emulator
  • The device is not rooted
  • The device has developer mode disabled
  • The app is not running on virtual environment, debug or any security threat
caution

If the ToPP Application detects any security threat it will close automatically.

Entities​

Tap on Phone with PIN Application (ToPP)​

The android application to perform contactless transactions.

Invocation SDK​

An SDK provided by Geopagos that communicates ToPP with Third Party Applications.

Third Party Application​

This is an integrating application that wants to use ToPP solution.

Third Party Backend​

A backend from the third party application that wants to use ToPP solution.

ToPP Identifier​

Identifies a ToPP versión installed on a physical device. This identifier is an object containing:

  • ToPP Application Name: a String with the Application Build Name.
Example: geopagos
  • ToPP Application version: a String with the Application Build Version.
Example: 1.2.1
  • Device fingerprint: a String that is unique per device.
Example: 9E:35:85:E6:76:76:09:E5:88:7B:7C:39:EB:ED:CF:2D:E2:3A:3B:9B:1A:8E:1F:89:EC:F3:D9:5A:D7:AF:A2:39

Geopagos API​

Is a backend service used to generate sessions and track ongoing transactions.

Tenant​

Identifies a third party ToPP consumer. This is provided by Geopagos along with other credentials to use our services.

Session​

Represents a transaction intent in progress requested by a Third Party Backend to the Monitor, to perform a transaction using ToPP solution. This Session is linked to a single ToPP instance by the ToPP Identifier. A session is valid until a transaction is completed or a security threat arises.

Sequence diagram​