> For the complete documentation index, see [llms.txt](https://commanderhelp.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://commanderhelp.verifone.com/feature-references/features-and-products-references/mobile-payments/configuring-mobile-payments/mobile-payment-configuration.md).

# Mobile Payment Configuration

From the Configuration Client, go to: Payment Controller > Mobile Payment Configuration.

<figure><img src="https://1800087076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2F9XdLm0NyluWf2kmCZvgw%2Fimage.png?alt=media&amp;token=eea8168e-d9de-4f30-8014-f7acb473bee0" alt=""><figcaption></figcaption></figure>

The Mobile Payment Configuration window displays.

![](https://content.gitbook.com/content/5nJgnNKJ9ZrZeEdr7pqh/blobs/LhP9HWzMoFWDqUayIZVR/images/rendered_016.png)

The following tabs are available for selection:

* Site Mobile Configuration
* Host Configuration

## Site Mobile Configuration

{% stepper %}
{% step %}
From the Mobile Configuration form, select the \[Site Mobile Configuration] tab.

![](https://content.gitbook.com/content/5nJgnNKJ9ZrZeEdr7pqh/blobs/uU0E1YAeLHlkeHVL2dAQ/images/rendered_018.png)
{% endstep %}

{% step %}
Select \[Accept Mobile Payments] to enable Mobile Payments.

<figure><img src="https://1800087076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2F5VbtkctVz2I11v6lWGj1%2Fimage.png?alt=media&amp;token=f4409bdc-5918-43e6-a3df-ee975f76e8a6" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Configure the following Site Configuration parameters.

<figure><img src="https://1800087076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FsbHuGFiTI8o90iErjzDJ%2Fimage.png?alt=media&amp;token=781edb1a-91e6-4ab8-afc6-6963a42c0c5f" alt=""><figcaption></figcaption></figure>

| Variable        | Value                                        |
| --------------- | -------------------------------------------- |
| Site Name       | The name of the site <20 characters>.        |
| Welcome Message | The site's welcome message <100 characters>. |
| {% endstep %}   |                                              |

{% step %}
Configure the following Miscellaneous Configuration parameters.

<figure><img src="https://1800087076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FltEIxkouSfEWJtDiybFq%2Fimage.png?alt=media&amp;token=7f6b161f-ce52-493a-8299-a575008b2ba5" alt=""><figcaption></figcaption></figure>

| Variable           | Value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| ------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Data Storage Time  | The Data Storage Time for retention <0-30 days>.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Site Address       | The site street address.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Latitude/Longitude | The site GPS coordinates.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| Report / Format    | The combination of these fields are used to set the format type for each report from the report drop-down. The values are "Standard" and "Extended Authorization". The default format type would be "Standard" for all reports. In the Chevron distribution, the Mobile Terminal Batch Detail Report will default to Extended Authorization format. Standard: In this format max limit for authorization number is 14 digits and first 14 digits gets printed. Extended Authorization Format: Min limit for authorization number is 1; no upper limit. As of now this feature is applicable only for Mobile Terminal Batch Detail Report. |
| {% endstep %}      |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |

{% step %}
Select \[Save] to accept, or \[Cancel] to exit without saving changes.
{% endstep %}
{% endstepper %}

## Host Configuration

{% stepper %}
{% step %}
From the Mobile Payment Configuration window, select the \[Host Configuration] tab.

<figure><img src="https://1800087076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2F1N6SxIW9INvT16PObUCd%2Fimage.png?alt=media&amp;token=230df8a3-2b16-45ee-acd6-f07c314a5806" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Click \[Add].

![](https://content.gitbook.com/content/5nJgnNKJ9ZrZeEdr7pqh/blobs/WH57gdWOEUhVo1qPUngA/images/rendered_023.png)
{% endstep %}

{% step %}
*Click to select \[Enable Host].*

<figure><img src="https://1800087076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FRSXoweibU31rv4QfwXvb%2Fimage.png?alt=media&amp;token=676b0b4e-804f-468f-a1da-914679165b9e" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
Configure the Host Configuration parameters.

{% hint style="info" %}
*If Scan Token is selected as the Authentication Type, the scanner must be programmed with a prefix “P01”to correctly identify QR Codes.*
{% endhint %}

<figure><img src="https://1800087076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FCf2o8BsgUl2Bu1kNgegG%2Fimage.png?alt=media&amp;token=50f91816-d994-449c-871d-fab102af56db" alt=""><figcaption></figcaption></figure>

| Variable                   | Value                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| -------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Adapter                    | <p>The site Adapter Type:</p><ul><li>FDC Mobile - ConnectorSwitch adapter or outdoor transactions.</li><li>VFIMobile V1 - for Conexxus V1 standards</li><li>VFIMobile V2 - for Conexxus V2 standards</li><li>Local MPPA - for Shell Distribution</li></ul>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| Program Name               | The Program Name                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| Merchant ID                | The Merchant ID number provided by the Mobile Payment Host.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| Authentication Type        | <p>The site Authentication Type:</p><ul><li>SCAN\_TOKEN: QR Code generated on the MPA is scanned using the POS scanner.</li><li>ENTER\_TOKEN: Customer or cashier enters token on the PIN pad.</li><li>DISPLAY\_TOKEN: Token for customer to enter is displayed on the PIN pad.</li><li>GENERATE\_TOKEN: Both Display\_Token and Generate\_Token display a token on the PIN pad to be scanned or entered for authenticating the transaction. If a site has different Mobile Payment programs configured with Generate\_Token authentication type for all, the customer is not prompted to select a mobile payment program during the transaction. After selecting mobile MOP, the PIN pad displays a QR Code instead of mobile payment program selection.</li></ul><p>If the Adapter type is 'FDC Mobile', then the field 'Authentication type' is disabled. This adapter allows only outdoor transactions.</p> |
| Site Terminal ID           | <p>ID number for the terminal received from the Mobile Payment Host.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Note: For Conexxus standards, Site\_terminal ID and Location ID are greyed out.</p></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| Location ID                | <p>The Location ID provided by the Mobile Payment Host; identifies the site during the on boarding process.</p><div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p>Note: For Conexxus standards, Site\_terminal ID and Location ID are greyed out.</p></div>                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| Store ID                   | The site Store ID number.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| Settlement Employee Number | The Settlement Employee Number provided by the Mobile Payment Host                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| Settlement Passcode        | The Settlement Passcode.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| Phone Number               | The Site Phone Number.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| Send Loyalty Details       | Enabling this flag will sends SLA/EPS loyalty program details to MPPA under Mobile Site Data Request.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| {% endstep %}              |                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |

{% step %}
Configure the Network Configuration parameters.

<figure><img src="https://1800087076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2FALL1eHzMooiO92r5eiqz%2Fimage.png?alt=media&amp;token=d5b98e00-722d-4afd-b99e-0c1baebd1ca8" alt=""><figcaption></figcaption></figure>

| Variable                   | Value                                                                                                                                                                           |
| -------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Address                    | The Host IP or URL. (IPv4 format or http domain name).                                                                                                                          |
| Port                       | The communications port number.                                                                                                                                                 |
| SSL Enabled                | Enables Secure Socket Layer (SSL) for client/ host communications.                                                                                                              |
| Heartbeat Frequency / Unit | The time after which the Commander Site Controller pings the mobile program host to check connection. If the host is offline, the mobile host offline alarm appears on the POS. |
| {% endstep %}              |                                                                                                                                                                                 |

{% step %}
Configure the following Miscellaneous Configuration parameters.

<figure><img src="https://1800087076-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F5nJgnNKJ9ZrZeEdr7pqh%2Fuploads%2Fvz3hTwpPdI3hvMQztlfC%2Fimage.png?alt=media&amp;token=cdd71540-1ee4-4e95-886a-dae13e14dd42" alt=""><figcaption></figcaption></figure>

| Variable                         | Value                                                                                                                                                                                                                                                                                                                                                               |
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Outdoor PreAuthorization Timeout | The DCR Pre-Authorization timeout (in seconds).                                                                                                                                                                                                                                                                                                                     |
| Site Initiated Loyalty           | <p>The Site Initiated Loyalty setting for outdoor transactions:</p><ul><li>Never Allow Site Entered Loyalty - Allow only mobile loyalty.</li><li>Allow Site Entry i.e., Swiped Loyalty Card - Both swiped and mobile loyalties are honored.</li><li>Allow Site Entered Loyalty if no Mobile Loyalty - Allow swiped loyalty if there is no mobile loyalty.</li></ul> |
| {% endstep %}                    |                                                                                                                                                                                                                                                                                                                                                                     |

{% step %}
Select \[Save] to accept, or \[Cancel] to exit without saving changes.
{% 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://commanderhelp.verifone.com/feature-references/features-and-products-references/mobile-payments/configuring-mobile-payments/mobile-payment-configuration.md?ask=<question>&goal=<user_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.
