Payment Attribution

Overview

Meaning and boundaries

Payment Attribution is the assignment of an observed transfer to the correct invoice, order, customer, account, or other business obligation. Attribution links an observed transfer to the business obligation it satisfies. Strong evidence may include a dedicated address, invoice identifier, transaction hash with network, expected token contract, amount, and time window. The matching rule should explain how it resolves collisions and ambiguous cases.

How it works in practice

An intake pipeline detects transfers, normalizes the chain-specific events, and proposes matches to open payment obligations. A deterministic rule can use a dedicated address, order reference, expected asset, time window, and precise amount. Ambiguous matches remain unresolved until verified evidence is available; a successful match then produces an auditable ledger allocation.

Checks and failure points

Do not assume a wallet sender is the customer: custodial services and pooled accounts can pay on behalf of others. Suspicious duplicates, reused addresses, and partial payments need review instead of automatic assignment.

Operational evidence and decisions

Attribution has to cope with batched transfers and one transaction containing multiple token events. The system may need output index, log index, memo, or unique address in addition to the transaction hash. When two obligations could claim the same value, preserve the funds as unmatched until an explicit rule resolves the ambiguity. The reconciliation system should retain both the proposed match and the final accepted allocation.

How it differs from related terms

Attribution identifies the correct obligation; confirmation determines whether the observed transfer meets the acceptance policy. Related entries: Order Attribution; Customer Attribution; Crypto Payment Matching.