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.

This is v2.62.0 of the Order Service API. See Deprecated APIs for legacy endpoints that should not be used in new integrations.

API Reference

Order Management

Name

Merchant Orders

Description

Create and update merchant onboarding orders

Name

POI Orders

Description

Create and update POI (terminal) orders and accessory orders for existing merchants

Name

Additional Services

Description

Create and update add-on service orders for existing merchants

Name

Hardware Orders

Description

Create and update standalone hardware draft orders

Name

Aml Documents

Description

List required AML/KYC documents, generate upload URLs, and delete uploaded documents

Name

Orders — Common

Description

Search, retrieve, submit, cancel orders; manage e-contracts, order links, and welcome letters

Name

Webhooks

Description

Webhook callbacks for Adobe Sign and Dokobit/Signicat e-signing events

Maintenance

Name

Merchant Maintenance

Description

Update merchant entities and trading addresses

Name

POI Maintenance

Description

Update and delete existing POI records

Name

Maintenance Orders

Description

Submit POI maintenance requests (swap, repair, warranty services)

Name

Multi Merchant

Description

Manage parent and child POI relationships in multi-merchant setups

For retired endpoints, see Deprecated APIs.

Internal

These endpoints are for Verifone internal use.

Name

Internal

Description

Verifone-internal account, status, and maintenance workflow endpoints

Name

Users

Description

Create unapproved merchant users for existing customer entities

Name

MID/TID Generation

Description

Generate Verifone Merchant IDs and Terminal IDs based on configured ranges

Name

Purchased TIDs

Description

Manage pre-purchased TID pools — insert, list, reserve, and update allocation status

Name

Reseller Event Data

Description

Manage reseller-scoped event data records used during order submission

Name

Oracle Accounts

Description

Search, add, update, and delete Oracle billing accounts

Name

Batch

Description

Verifone internal batch operations for merchant and POI maintenance

Key Concepts

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.

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.

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.

POI

The Point of Interaction (POI) refers primarily to the logical terminal — the device through which a payment is initiated and processed.

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.