Order Attribution

Overview

What it means

Order attribution is identifying which customer order or commercial obligation an observed payment belongs to. Accurate attribution lets a merchant deliver the right item, investigate problems and reconcile revenue.

How it works

A gateway can use a unique invoice identifier, per-order deposit address, required memo or a combination of merchant reference and transaction evidence. The mapping should survive retries, late payments and partial transfers. Where one address is reused, careful matching and manual exceptions become more important.

Understanding the technical details

Attribution design begins at invoice creation. Use a distinct invoice reference or deposit address where feasible, then preserve the mapping in a durable database before presenting it to the buyer. If customers reuse an old destination, the monitor should not blindly credit the newest invoice at that address. A safe exception path examines amounts, timestamps and previous claims with an audit trail. Reconciliation should confirm every legitimate transfer was allocated exactly once. When shared deposit infrastructure requires a memo or tag, store it with the invoice and validate it at detection time. An address-only join is not enough in that architecture.

Common failures and limitations

Public blockchain data generally does not identify the legal customer or purchase without off-chain context. Never publish private customer identity in on-chain memos if avoidable. Fraudsters may claim an unrelated TxID as proof of their own payment.

Related concepts

Crypto Checkout, Crypto Refund, Payment-to-Order Reconciliation.

Further reading

OxaPay — Developer documentation.