# Getting started

Use this guide to get from setup to a working test quickly.

You can start with a simulator or a physical terminal.

{% if visitor.isSet === false %}
{% columns %}
{% column %}

<h4 align="center"><strong>Please login or register to gain access to the detailed material on this page.</strong></h4>
{% endcolumn %}

{% column %}

<p align="right"><a href="https://identity.verifone.com/am/XUI/?realm=/alpha&#x26;authIndexType=service&#x26;authIndexValue=DocsLoginV7&#x26;goto=https://docs.verifone.com/" class="button primary" data-icon="shield-keyhole">Login</a><a href="https://partner-registration.verifone.com/" class="button secondary">Register for an Account</a></p>
{% endcolumn %}
{% endcolumns %}
{% endif %}

## What you need

Before you begin, make sure you have:

* Access to Verifone Central.
* An onboarded terminal or a simulator test path.
* Postman and the integrator collection.
* An API key, user UID, and Basic Auth token.

{% hint style="info" %}
POS Cloud Integration is available in the United States, EMEA, and Australia.
{% endhint %}

{% if visitor.isSet === true %}

## Choose your setup path

* Use [POS Cloud Integration Setup](broken://spaces/UVu9DsxYvTxoeKel5Uf7/pages/1uJRcW4auqbCiOv7xbsf) if you need merchant, device, and terminal setup.
* Use [Simulator in sandbox environment](broken://spaces/UVu9DsxYvTxoeKel5Uf7/pages/4pWhHJgbC2dL9DgCUedj) if you want to test without a physical device.
* Use [Basic Authentication](broken://spaces/UVu9DsxYvTxoeKel5Uf7/pages/FpQDS8FxdZdvkUmoPhac) to generate the credentials you need for every request.
  {% endif %}

## Quick start

{% stepper %}
{% step %}

### Set up your account and device

Complete merchant onboarding and device onboarding first.

If you are using a physical terminal, confirm POS Cloud is enabled on the device.
{% endstep %}

{% step %}

### Generate credentials

Create an API key in Verifone Central.

Copy your user UID.

Use both values to generate your Basic Auth token.
{% endstep %}

{% step %}

### Prepare Postman

Import the integrator collection.

If you are testing with the simulator, add the `x-terminal-simulator` header and set it to `true`.
{% endstep %}

{% step %}

### Send your first request

Start with a connection or status request.

Then run a simple sale to confirm the full payment flow works.
{% endstep %}
{% endstepper %}

{% if visitor.isSet === true %}

## First test flow

{% tabs %}
{% tab title="Simulator" %}

1. Open the imported integrator collection in Postman.
2. Set authorization to `No Auth` on the request.
3. Add your Basic Auth token in the `Authorization` header.
4. Add `x-terminal-simulator: true`.
5. Send a test payment or status request.

Use [Testing integration](broken://spaces/UVu9DsxYvTxoeKel5Uf7/pages/65yEIpsLyYqswfu4uRzm) for simulator scenarios and expected responses.

{% hint style="warning" %}
The `/payment` endpoint times out after 300 seconds if the terminal does not respond. Other endpoints time out after 60 seconds.
{% endhint %}

## Recommended next steps

{% endtab %}

{% tab title="Physical terminal" %}

1. Confirm the terminal is onboarded and reachable.
2. Confirm POS Cloud is enabled on the terminal.
3. Import the integrator collection in Postman.
4. Add your Basic Auth token.
5. Run a status request, then run a sale.

Use [Testing Transaction Capabilities](broken://spaces/UVu9DsxYvTxoeKel5Uf7/pages/ZVtdFeXF8BvkjJGgp95T) for the terminal test flow.<br>

{% hint style="warning" %}
The `/payment` endpoint times out after 300 seconds if the terminal does not respond. Other endpoints time out after 60 seconds.
{% endhint %}

## Recommended next steps

* Review [Introduction](broken://spaces/UVu9DsxYvTxoeKel5Uf7/pages/QTxATOJSN4JbrITWkyPZ) for the product scope.
* Use [Sale](broken://spaces/UVu9DsxYvTxoeKel5Uf7/pages/71a44c2252b418ea2be9565fe8a9ee2be12ad7b0) to understand the standard payment flow.
* Explore [Payment Operations](broken://spaces/UVu9DsxYvTxoeKel5Uf7/pages/jWoXdg4sqYIDP3bU3Vj7) for the full API surface.
  {% endtab %}
  {% endtabs %}
  {% endif %}


---

# 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://docs.verifone.com/pos-cloud/getting-started.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.