Order ID

Definition

Order ID is a system-assigned identifier that uniquely distinguishes an order within a defined scope. In order and fulfillment operations, it commonly covers database key, public order number, channel prefix, store scope, and mapping to external systems. It differs from an order reference when the reference is merchant-defined, customer-facing, or not guaranteed to be the primary internal key.

Overview

Meaning and scope

Mechanism and operation

The concept commonly includes database key, public order number, channel prefix, store scope, and mapping to external systems. It normally interacts with Order Reference and Merchant Reference, although the exact system boundaries vary by merchant and platform. Controls for Order ID should define permitted state transitions, authoritative services, idempotency rules, reconciliation cutoffs, manual-override permissions, and recovery after partial completion.

Practical payment example

An integration receives duplicate payment webhooks for order 9081. Its database uses the stable order ID to correlate updates while an event ID controls duplicate processing.

Operational checks

Order identifiers should be stable and unique within the appropriate merchant namespace. Keep them separate from invoice IDs, webhook event IDs and transaction hashes because one order can involve multiple attempts and transfers. Pass the identifier through checkout and refund records without treating possession of the number as permission to change an order. Enforce uniqueness and relationship constraints in the database. Use composite uniqueness where separate sellers or platforms can legitimately assign the same human-readable order number.

Distinctions and limits

Order ID is a system-assigned identifier that uniquely distinguishes an order within a defined scope. It must remain linked to the correct customer, totals, payment, fulfillment, and correction history.

Related definitions: Order Reference, Merchant Reference.

Example