> For the complete documentation index, see [llms.txt](https://docs.verifone.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.verifone.com/api-reference/open-api-references/order-service.md).

# Order Service

The **Order Service API** enables partners and integrators to order hardware and services, provision and board devices, and manage the full lifecycle of merchant and POI entities. It supports merchant onboarding, additional service ordering, terminal provisioning, batch processing, e-contract workflows, and webhook callbacks from third-party signing providers.

{% hint style="info" %}
This is **v2.62.0** of the Order Service API. See [Deprecated APIs](/api-reference/open-api-references/order-service/deprecated-api.md) for legacy endpoints that should not be used in new integrations.
{% endhint %}

## API Reference

### Order Management

<table data-view="cards"><thead><tr><th>Name</th><th>Description</th><th data-hidden data-card-target data-type="content-ref">Page</th></tr></thead><tbody><tr><td><strong>Merchant Orders</strong></td><td>Create and update merchant onboarding orders</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/a2cf59ab40c49f209a0c07d11686cfaf7ec133f2">/spaces/OiXbo96Og9EN7rz2U44K/pages/a2cf59ab40c49f209a0c07d11686cfaf7ec133f2</a></td></tr><tr><td><strong>POI Orders</strong></td><td>Create and update POI (terminal) orders and accessory orders for existing merchants</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/e40cb8455556745f1c63af5dfce91c0c69061c04">/spaces/OiXbo96Og9EN7rz2U44K/pages/e40cb8455556745f1c63af5dfce91c0c69061c04</a></td></tr><tr><td><strong>Additional Services</strong></td><td>Create and update add-on service orders for existing merchants</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/p3p5Jf8rWIf5DdtZs88i">/spaces/OiXbo96Og9EN7rz2U44K/pages/p3p5Jf8rWIf5DdtZs88i</a></td></tr><tr><td><strong>Hardware Orders</strong></td><td>Create and update standalone hardware draft orders</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/aAzO6gU7Fipi2taBRDCZ">/spaces/OiXbo96Og9EN7rz2U44K/pages/aAzO6gU7Fipi2taBRDCZ</a></td></tr><tr><td><strong>Aml Documents</strong></td><td>List required AML/KYC documents, generate upload URLs, and delete uploaded documents</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/45afnlfkyfcp6kjRl11a">/spaces/OiXbo96Og9EN7rz2U44K/pages/45afnlfkyfcp6kjRl11a</a></td></tr><tr><td><strong>Orders — Common</strong></td><td>Search, retrieve, submit, cancel orders; manage e-contracts, order links, and welcome letters</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/d86321bc501d71ffd2719e7903da5b32e42b0edc">/spaces/OiXbo96Og9EN7rz2U44K/pages/d86321bc501d71ffd2719e7903da5b32e42b0edc</a></td></tr><tr><td><strong>Webhooks</strong></td><td>Webhook callbacks for Adobe Sign and Dokobit/Signicat e-signing events</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/00ce833ffb9503ecab93c2a41de5c372f9844e73">/spaces/OiXbo96Og9EN7rz2U44K/pages/00ce833ffb9503ecab93c2a41de5c372f9844e73</a></td></tr></tbody></table>

### Maintenance

<table data-view="cards"><thead><tr><th>Name</th><th>Description</th><th data-hidden data-card-target data-type="content-ref">Page</th></tr></thead><tbody><tr><td><strong>Merchant Maintenance</strong></td><td>Update merchant entities and trading addresses</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/c74dcebd3e6c3a40d1098a2c5d4a4fd436f7d98e">/spaces/OiXbo96Og9EN7rz2U44K/pages/c74dcebd3e6c3a40d1098a2c5d4a4fd436f7d98e</a></td></tr><tr><td><strong>POI Maintenance</strong></td><td>Update and delete existing POI records</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/a316250302d933100ed5b118eb449916975ac19f">/spaces/OiXbo96Og9EN7rz2U44K/pages/a316250302d933100ed5b118eb449916975ac19f</a></td></tr><tr><td><strong>Maintenance Orders</strong></td><td>Submit POI maintenance requests (swap, repair, warranty services)</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/b051b3423b2c49b21e59df5ca19916dc4338abb3">/spaces/OiXbo96Og9EN7rz2U44K/pages/b051b3423b2c49b21e59df5ca19916dc4338abb3</a></td></tr><tr><td><strong>Multi Merchant</strong></td><td>Manage parent and child POI relationships in multi-merchant setups</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/L0DoQIr8Y0geaF0Wfbk3">/spaces/OiXbo96Og9EN7rz2U44K/pages/L0DoQIr8Y0geaF0Wfbk3</a></td></tr></tbody></table>

For retired endpoints, see [Deprecated APIs](/api-reference/open-api-references/order-service/deprecated-api.md).

### Internal

{% hint style="warning" %}
These endpoints are for Verifone internal use.
{% endhint %}

<table data-view="cards"><thead><tr><th>Name</th><th>Description</th><th data-hidden data-card-target data-type="content-ref">Page</th></tr></thead><tbody><tr><td><strong>Internal</strong></td><td>Verifone-internal account, status, and maintenance workflow endpoints</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/amud282m6ShNn1SSXTiE">/spaces/OiXbo96Og9EN7rz2U44K/pages/amud282m6ShNn1SSXTiE</a></td></tr><tr><td><strong>Users</strong></td><td>Create unapproved merchant users for existing customer entities</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/ry20Lo2ZCnM2lTNGztEw">/spaces/OiXbo96Og9EN7rz2U44K/pages/ry20Lo2ZCnM2lTNGztEw</a></td></tr><tr><td><strong>MID/TID Generation</strong></td><td>Generate Verifone Merchant IDs and Terminal IDs based on configured ranges</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/9413cc4f7a841f1c98bd1055186542b5efa5633c">/spaces/OiXbo96Og9EN7rz2U44K/pages/9413cc4f7a841f1c98bd1055186542b5efa5633c</a></td></tr><tr><td><strong>Purchased TIDs</strong></td><td>Manage pre-purchased TID pools — insert, list, reserve, and update allocation status</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/54ae6a81479eed102db98d14d0b574a672c1a064">/spaces/OiXbo96Og9EN7rz2U44K/pages/54ae6a81479eed102db98d14d0b574a672c1a064</a></td></tr><tr><td><strong>Reseller Event Data</strong></td><td>Manage reseller-scoped event data records used during order submission</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/vuZnWuOzk3RZ6OcwAjEP">/spaces/OiXbo96Og9EN7rz2U44K/pages/vuZnWuOzk3RZ6OcwAjEP</a></td></tr><tr><td><strong>Oracle Accounts</strong></td><td>Search, add, update, and delete Oracle billing accounts</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/cdb10995b7b124008994c40b5609d86dd6ae3576">/spaces/OiXbo96Og9EN7rz2U44K/pages/cdb10995b7b124008994c40b5609d86dd6ae3576</a></td></tr><tr><td><strong>Batch</strong></td><td>Verifone internal batch operations for merchant and POI maintenance</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/26d4189c99428489976b008c55aed2458588d778">/spaces/OiXbo96Og9EN7rz2U44K/pages/26d4189c99428489976b008c55aed2458588d778</a></td></tr></tbody></table>

## Key Concepts

{% tabs %}
{% tab title="Order" %}
An **order** is a collection of instructions for provisioning and ordering applications and hardware. Orders go through a draft state before being submitted for processing.
{% endtab %}

{% tab title="Merchant / Customer" %}
A **merchant** is the person or entity taking payments for goods and services. A **customer** is an acquirer, merchant, or other entity being charged for hardware or services from Verifone.
{% endtab %}

{% tab title="Service / Additional Services" %}
A **service** is a subscribed application, payment feature, or hardware lifecycle add-on. **Additional Services** let you attach these services to an existing merchant without creating a full merchant onboarding order.
{% endtab %}

{% tab title="POI" %}
The **Point of Interaction (POI)** refers primarily to the logical terminal — the device through which a payment is initiated and processed.
{% endtab %}

{% tab title="Acquirer" %}
An **acquirer** is a bank or financial institution that processes card payments on behalf of merchants. In the Verifone model, acquirers are typically direct Verifone customers whose merchants are not.
{% endtab %}
{% endtabs %}


---

# 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 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/api-reference/open-api-references/order-service.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.