Customer Wallet

Definition

A customer wallet is a wallet or wallet-linked account associated with a specific customer for receiving, holding, sending, or identifying that customer's assets and transactions. Reliable use of Customer Wallet depends on clear signing authority, network-aware transaction review, protected recovery data, and records that connect each wallet action to its resulting balance change.

Overview

Meaning and scope

A customer wallet is a wallet or wallet-linked account associated with a specific customer for receiving, holding, sending, or identifying that customer’s assets and transactions. Reliable use of Customer Wallet depends on clear signing authority, network-aware transaction review, protected recovery data, and records that connect each wallet action to its resulting balance change.

Mechanism and operation

A business may create a custodial subaccount, assign deposit addresses, connect an external self-custody wallet, or maintain wallet metadata for a customer. One customer wallet may contain many addresses and networks, while one shared on-chain wallet may support many customer balances. Identity, address ownership, ledger balance, and signing authority should therefore be stored as separate relationships. Reusing a wallet identifier across networks can produce routing and screening errors. Systems should define who controls keys, which assets and networks are supported, how deposits are credited, how withdrawals are authorized, and what happens after account closure.

Practical payment example

An online marketplace allows each shopper to connect a personal wallet. Checkout checks network and signing permissions without assuming the platform has custody of the wallet’s assets.

Operational checks

Customer-level records must reconcile to actual holdings and preserve privacy. The label should never imply on-chain segregation unless that structure is genuinely implemented. For Customer Wallet, a wallet interface or provider response can report progress, but it cannot replace verified transaction and ledger evidence.

Distinctions and limits

These models have different control and ownership consequences even when the interface uses the same label. The Customer Wallet workflow operates through several distinct states: request creation, user or policy approval, signature generation, network submission, execution, confirmation, balance recognition, and accounting. Material risks for Customer Wallet include credential compromise, malicious destinations, unsupported assets, wrong-network transfers, stale balances, compromised software, provider outage, privacy leakage, and inaccessible recovery material.

Related definitions: self-custody wallet, wallet metadata.

Example