# PayContactless Embed

## Solution Architecture

<figure><img src="https://3209134532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcLvbYKDk7En5o0Lfwh2V%2Fuploads%2FYyUdL9JRi04HiUuDjUlF%2FScreenshot%202022-10-11%20at%2013.57.47.png?alt=media&#x26;token=9644485e-d606-4c51-b826-df24b024caa4" alt=""><figcaption></figcaption></figure>

## Prerequisites

1. **Supported Devices and Versions**:
   * The device should run on **Android 8.1** or higher versions.
2. **Google Service & Play Integrity**:
   * The device must support all necessary Google Services, including **Play Integrity**.
3. **NFC Support**:
   * For licenses that enable Tap to Phone functionality, the device must be equipped with **NFC support**.
4. **Device Restrictions**:
   * **Emulators**, devices with **custom ROMs**, and **rooted devices** are strictly prohibited.

## Credentials

### API Key <a href="#id-4.1.-api-key" id="id-4.1.-api-key"></a>

To utilize the PayContactless Embed SDK, an API Key provided by Prophius is essential. If you haven't acquired one yet, kindly reach out to the Prophius team for assistance.

The primary function of the API Key is to authenticate and tailor the SDK according to the specific requirements of the integrator. Please note, that the API Key maintains a validity period during the initial onboarding phase.

The PayContactless Business App boasts an array of payment functionalities. Depending on your preference, the integrating application can either support a singular payment type or encompass all available options. The capabilities linked with your API Key will be tailored based on your chosen license type

For your convenience, the diverse license types supported are enumerated below:

**License Types**

* Tap Card on Mobile (contactless cards)
* Pay with Account (via BLE )
* Pay with QR ( includes NQR & other QR services)
* Pay with Link

## Merchant Info <a href="#id-4.2.-merchant-info" id="id-4.2.-merchant-info"></a>

PayContactless Embed SDK needs some details about the business to prepare and download the merchant-related information to the PayContactless Business App. The required fields are described in the table below.

| Field Name             |             | Optional / Mandatory |
| ---------------------- | :---------: | :------------------: |
| Merchant ID            | Transaction |           M          |
| Terminal ID            | Transaction |           M          |
| Merchant Category Code | Transaction |           O          |
| Business Name          | Transaction |           O          |
| City                   | Transaction |           O          |
| State                  | Transaction |           O          |
| Country                | Transaction |           O          |
| First Name             | Interaction |           O          |
| Last Name              | Interaction |           O          |
| Email                  | Interaction |           O          |
| Phone Number           | Interaction |           O          |

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><strong>Backend Integration</strong></td><td>Get all the apis you need to integrate</td><td></td><td><a href="https://3209134532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcLvbYKDk7En5o0Lfwh2V%2Fuploads%2FoU3bsWQ4x7V1Y7freMJL%2F62a316e86817be18625d90fe_Rectangle%2013%20(3)-min.jpg?alt=media&#x26;token=cfca091a-cd79-445e-b91f-8499232e45c3">62a316e86817be18625d90fe_Rectangle 13 (3)-min.jpg</a></td><td><a href="broken-reference">Broken link</a></td></tr><tr><td><strong>Mobile SDK</strong> </td><td>Start to use our mobile SDK</td><td></td><td><a href="https://3209134532-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FcLvbYKDk7En5o0Lfwh2V%2Fuploads%2F1YKm3L1u8tlZYcrJcVFL%2Fmobile_sdk.jpeg?alt=media&#x26;token=a90b0362-c98b-414f-955d-87b1eef8851b">mobile_sdk.jpeg</a></td><td><a href="../merchant-embed-sdk">merchant-embed-sdk</a></td></tr></tbody></table>
