Address Network Mismatch

Overview

Context and purpose

Address Network Mismatch is a context error rather than necessarily a character-format error. An 0x address can be syntactically valid on several EVM-compatible networks, but the payment request identifies one specific chain and token route. The system should validate address, Supported Network , pay currency, and token contract as one combination. Checking only whether the address parses correctly cannot establish that the provider monitors the selected destination on that network. Format mismatch means the string does not meet the expected encoding or destination type. Network mismatch can involve a perfectly well-formed address used on the wrong chain. If the same private key controls the destination on both chains, a provider might technically recover funds, but token contracts, account activation, operational policy, or unsupported infrastructure can still make recovery unavailable. Checkout interfaces should bind network selection before displaying the address and repeat the network beside the QR code and amount.

How it works

A network mismatch means an address or payment instruction is interpreted under a different blockchain than the one intended. Some EVM networks reuse the same address shape, making visual inspection unreliable.

Practical checks and failure points

Bind invoice to explicit chain ID and token contract; show the full network name and avoid relying on ticker or address format alone.

Related concepts

Invoice Network · Address Format Mismatch