# 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, terminal provisioning, batch processing, e-contract workflows, and webhook callbacks from third-party signing providers.

{% hint style="info" %}
This is **v2.31.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

<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>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>Merchant Orders</strong></td><td>Create and update merchant orders; add additional services to existing merchants</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>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><tr><td><strong>Merchant Maintenance</strong></td><td>Update merchant entities, trading addresses, and create unapproved users</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 POIs; manage multi-merchant parent/child relationships</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/a316250302d933100ed5b118eb449916975ac19f">/spaces/OiXbo96Og9EN7rz2U44K/pages/a316250302d933100ed5b118eb449916975ac19f</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>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>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>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>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><tr><td><strong>Deprecated APIs</strong></td><td>Legacy endpoints superseded by newer versions — do not use in new integrations</td><td><a href="/spaces/OiXbo96Og9EN7rz2U44K/pages/3de816adebfea437121118e95c7030a6855d93f2">/spaces/OiXbo96Og9EN7rz2U44K/pages/3de816adebfea437121118e95c7030a6855d93f2</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="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: 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.