# 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>


---

# 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://developer.prophius.com/developer-console/paycontactless/paycontactless-embed.md?ask=<question>
```

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.