Unique Payment Address

Overview

Understand the idea

A unique payment address is a receiving destination assigned to one invoice, order or payer so incoming transfers can be matched more reliably. Its purpose is attribution: when several customers pay similar amounts, the destination itself helps identify the intended obligation. The address can be derived from a wallet's existing key hierarchy, generated under another controlled method or allocated by an infrastructure provider.

What actually happens

For each new invoice, a service reserves an address, stores a mapping from that address to the invoice and watches its blockchain activity. If the transaction arrives, the monitor checks the asset, network, amount and confirmation state before crediting the invoice. Some networks require token-account preparation, native fee funds or sweep transactions to consolidate deposits. Address allocation must be collision-safe and recoverable after database outages; the derivation index or assignment record is part of the backup.

A system that generates addresses at scale also needs a precise failure-recovery model. If the checkout database loses the mapping between address and invoice, the funds remain on-chain but may not be attributable to the payer. Back up derivation indexes or watch-only descriptors, maintain assignment logs, and never reissue a previously exposed address to an unrelated customer. Where funds later move from individual addresses to a treasury wallet, record sweep transaction IDs and their associated network fees without treating the sweep as a second customer payment.

Decisions and failure cases

One invoice can still receive partial, late or duplicate transfers. A unique address does not make the transfer automatically correct and does not prevent address poisoning or payment to a fraudulent replacement address. Issuing unused addresses can also create monitoring and sweep overhead. Audit any later reassignment; addresses should not silently point to unrelated new orders.

Related concepts

Watch-Only Wallet, UTXO Management, Multisig Wallet.

Further reading

Bitcoin developer guide: wallets.