> 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/customer-documentation/petro-and-c-store/commander-central/commander-central-user-guide/connect-device-to-cloud.md).

# Connect Device to Cloud

The Connect Device to Cloud section will provide details on how to enable the Cloud Connect feature in Verifone Configuration Client. Each Verifone Commander must be onboarded to the cloud within Verifone Configuration Client and added to Verifone Commander Central.

{% hint style="info" %}
If the site's information was not added to Verifone Commander Central prior to completing the Verifone Configuration Client onboarding steps, the site will automatically be added to Sites within Verifone Commander Central.

The site name will be the site's Service ID and the hierarchy will need to be modified.
{% endhint %}

### Requirements

* The site where the device is located is set up within Verifone Commander Central within Administration > Sites.
* The Verifone Commander onboarder must have credentials for Verifone Commander Central.
* DNS must be enabled within Verifone Configuration Client (Local Area Network Configuration) for the connection to be successful.

### Pre-Release 54.02 - Connecting Device to Verifone Commander Central

{% stepper %}
{% step %}
**Cloud Connect**

Log in as Manager in Verifone Configuration Client and navigate to Initial Setup > Cloud Connect.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2F4yELxS5A48JkUiWlazoY%2Fimage.png?alt=media&amp;token=ac397351-5c78-4fc5-a6ce-1e5bc52fd7cf" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Cloud Connect Button**

Select the Cloud Connect button from the screen.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FYrTcocMpvsEHlt3lEtdv%2Fimage.png?alt=media&amp;token=3870a187-8f03-40bc-b3bd-0756a8bf3bbb" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**URL and User Code**

A URL and a user code are generated. Copy the User Code that was generated on your Configuration Client and then select the URL on your screen.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FHstlIeY1yuVl2ciEzCJp%2Fimage.png?alt=media&amp;token=cc0bea83-4911-477d-b1cd-2e3858a87681" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Enter the Code**

After the URL opens, enter the user code from Configuration Client into the ‘Enter your code here’ field and click Submit.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FWujKgNowiBStwgJPGaqA%2Fimage.png?alt=media&amp;token=25f6eb6e-0da6-446a-84ea-dd22f28cda60" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**New Site**

Click Yes, log into the new site. A page will open that will prompt you to log into Verifone Commander Central.
{% endstep %}

{% step %}
**Log in**

Login with the credentials for Verifone Commander Central.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FXb3NwcHDFcuOF5KA9sdq%2Fimage.png?alt=media&amp;token=9fd54f5c-7220-42b1-bdb4-15699f742533" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Sharing the Information**

The next prompt will prompt you to allow sharing the information from the Verifone Commander. Select **Allow**. A message will display ‘DONE!’.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FMBr7gWzZmgefUYt18YPz%2Fimage.png?alt=media&amp;token=5a6de502-ed10-4742-a9e0-69b20a25c557" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Configuration Client**

Return to the Configuration Client page. Select Confirm Verification from the Cloud Connect window.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2F72WxZ5QIAZ82BzjFZnFA%2Fimage.png?alt=media&amp;token=d7128f8b-65c0-46ab-8799-cfff69b4c017" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Registration Completed**

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FSxkigh0d8M2z0bsbYT8b%2Fimage.png?alt=media&amp;token=dd9f0479-b6dd-4d34-9942-17193dd3d8bd" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
There is a 5-minute delay from when the site will show Active within Verifone Commander Central after it is registered.
{% endhint %}

{% hint style="warning" %}
**If DNS is not enabled in Configuration Client > Initial Setup > Local Area Network Connection, then the Verifone Commander will not be able to resolve the IP from the URL and onboarding will fail.**
{% endhint %}

{% hint style="info" %}
**T-Log data after onboarding**\
Transactions run before a Commander is onboarded to Verifone Commander Central will not appear in the T-Log Viewer, even after onboarding completes. T-Log data begins flowing to the cloud starting with the first period close after onboarding — transactions from the period in progress at the time of onboarding, and any period before it, are not included. This is expected behavior: T-Log and reporting data are organized by period boundary, and pre-onboarding activity is not backfilled.
{% endhint %}

### Troubleshooting

#### Error response ‘User Code has Expired. Please start the registration again.’

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2Fe2BrIwFOel6IJYDubVeQ%2Fimage.png?alt=media&amp;token=097c03be-6575-4e51-ae86-8c4e6b3b3a6c" alt=""><figcaption></figcaption></figure>

Make sure the user trying to onboard the Verifone Commander has the ‘Commander Onboarder Role’ assigned within Verifone C-Site. If the role has been assigned to the user, then contact the Verifone Helpdesk. The expiration time for the user code is 14 minutes, but the role assignment issue will appear immediately.

#### Error response ‘Communication error, please check network settings.’

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FrS7G15zoZyN12TuoAxNc%2Fimage.png?alt=media&amp;token=da7329af-4f8a-4ef2-846f-1a22fdd313ea" alt=""><figcaption></figcaption></figure>

For the following payment networks, no routes need to be added into Initial setup > LAN Configuration as the MNSP will make the changes needed: BP, Sunoco, and Chevron\*. Chevron is making the changes to the MNSP with the assumption that the Payment NIC is configured for the default route. If the Payment NIC is not the default route, then it needs to be changed to the default route, saved, and the Verifone Commander must be rebooted. See the Chevron Playbook for more details.

For Shell, Generic Buypass, etc. where the Payment NIC is NOT the default route, then DNS routes are required. DNS 1 8.8.8.8 and DNS 2 8.8.4.4 – Unless other DNS routes are required by the site’s network administrator.

Site such as Exxon, Generic Buypass (Gulf, Sinclair, etc.) and others who do not have their own IP scheme and has the Payment NIC set as the default route would need to add the following Host Routes and DNS settings into Initial Setup > LAN Configuration:

**Host Routes**

<table><thead><tr><th valign="top">Host Route Description</th><th valign="top">IP Address</th><th valign="top">Gateway</th><th valign="top">Subnet</th></tr></thead><tbody><tr><td valign="top">C-Site VAM 1</td><td valign="top">23.23.135.174</td><td valign="top">192.168.31.31</td><td valign="top">255.255.255.255</td></tr><tr><td valign="top">C-Site VAM 2</td><td valign="top">18.213.229.217</td><td valign="top">192.168.31.31</td><td valign="top">255.255.255.255</td></tr><tr><td valign="top">C-Site VIC 1</td><td valign="top">34.117.16.222</td><td valign="top">192.168.31.31</td><td valign="top">255.255.255.255</td></tr><tr><td valign="top">C-Site GSC 1</td><td valign="top">184.72.129.214</td><td valign="top">192.168.31.31</td><td valign="top">255.255.255.255</td></tr><tr><td valign="top">C-Site GSC 2</td><td valign="top">54.221.203.197</td><td valign="top">192.168.31.31</td><td valign="top">255.255.255.255</td></tr><tr><td valign="top">C-Site GSC 3</td><td valign="top">52.72.155.235</td><td valign="top">192.168.31.31</td><td valign="top">255.255.255.255</td></tr><tr><td valign="top">C-Site MQTT 1</td><td valign="top">184.73.231.196</td><td valign="top">192.168.31.31</td><td valign="top">255.255.255.255</td></tr><tr><td valign="top">C-Site MQTT 2</td><td valign="top">3.212.149.223</td><td valign="top">192.168.31.31</td><td valign="top">255.255.255.255</td></tr><tr><td valign="top">C-Site MQTT3</td><td valign="top">52.6.28.56</td><td valign="top">192.168.31.31</td><td valign="top">255.255.255.255</td></tr><tr><td valign="top">DNS 1</td><td valign="top">8.8.8.8</td><td valign="top">192.168.31.31</td><td valign="top">255.255.255.255</td></tr><tr><td valign="top">DNS 2</td><td valign="top">8.8.4.4</td><td valign="top">192.168.31.31</td><td valign="top">255.255.255.255</td></tr></tbody></table>

**DNS Settings**

* DNS 1: 8.8.8.8
* DNS 2: 8.8.4.4

## Release 54.02+ - Connecting Device to Verifone Commander Central

In Verifone Commander software release 54.02 and higher, there have been enhancements made to onboard the Verifone Commander. The steps have been simplified from previous releases.

{% hint style="info" %}
Ensure that the instructions are followed for the correct software release installed on the Verifone Commander prior to beginning onboarding.
{% endhint %}

{% stepper %}
{% step %}
**Verifone Configuration Client**

Log into Verifone Configuration Client and navigate to Initial Setup > Connect to Verifone Commander Central.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2Fnvo6LaMXwbvYuhl4oJ38%2Fimage.png?alt=media&amp;token=e6efa643-ee91-4e61-a727-18802f08c797" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Login Credentials**

Enter the C-Site Email and Password to connect the Verifone Commander to C-Site. Do not use the Verifone Configuration Client Credentials – they will not work. If the site doesn’t have an account, selecting the ‘Don’t have an account?’ option will provide information for the site to sign up for Verifone Commander Central.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FO5e5elo2TaodDM5r0uet%2Fimage.png?alt=media&amp;token=7d13d9bf-0434-4884-9515-9437041059e9" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Connection**

When the correct credentials are entered, Verifone Configuration Client will display ‘Connecting to Verifone Commander Central in Progress’.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FvpYYkRcpQBDSsU8UvmyZ%2Fimage.png?alt=media&amp;token=0352cda6-3719-49a1-99b2-5d0ea6314cbe" alt=""><figcaption></figcaption></figure>
{% endstep %}

{% step %}
**Onboarding Complete**

After the onboarding is complete, the message below displays.

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FWl5MFNRvaHQbyQLYB17H%2Fimage.png?alt=media&amp;token=6b032723-5442-4794-ac88-0f98b5526b93" alt=""><figcaption></figcaption></figure>
{% endstep %}
{% endstepper %}

{% hint style="info" %}
**T-Log data after onboarding**\
Transactions run before a Commander is onboarded to Verifone Commander Central will not appear in the T-Log Viewer, even after onboarding completes. T-Log data begins flowing to the cloud starting with the first period close after onboarding — transactions from the period in progress at the time of onboarding, and any period before it, are not included. This is expected behavior: T-Log and reporting data are organized by period boundary, and pre-onboarding activity is not backfilled.
{% endhint %}

## Troubleshooting

#### Error message ‘Invalid credentials, please try again. Please make sure you are using your Commander Central credentials to login’

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2Fp08DKXei2dV33tBbhjsB%2Fimage.png?alt=media&amp;token=9074df89-ca9b-4b0c-a0be-2561f7005868" alt=""><figcaption></figcaption></figure>

Confirm the Verifone Commander Central Credentials are being used and not the Verifone Configuration Client Credentials.

#### Error message ‘Wrong Serial Number – Service ID Mapping. Please contact helpdesk’

<figure><img src="https://2845923820-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Ff8N3RLcEwSqYn1EvDXrj%2Fuploads%2FwKji41vR0CbYErSMEYK5%2Fimage.png?alt=media&amp;token=fb067208-4e27-4601-84d0-3db8473d01f1" alt=""><figcaption></figcaption></figure>

* The service ID may be incorrect in the Verifone Commander. Confirm the site’s service ID is entered in by navigating to Help > Support in Configuration client to verify it is correct. If the service ID entered is incorrect, contact the Verifone helpdesk to correct the service ID.
* Verifone Commander serial number may not match what the site has registered. Reach out to the Verifone Helpdesk to correct the Verifone Commander Serial number and/or Service ID.


---

# 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/customer-documentation/petro-and-c-store/commander-central/commander-central-user-guide/connect-device-to-cloud.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.
