Skip to main content
Solana Mainnet has two similar-looking identifiers. They serve different purposes and both are correct. The CAIP-2 chain reference is the first 32 characters of the genesis hash because CAIP-2 chain references have a 32-character limit. Do not append the remaining genesis-hash characters to an x402 network field. Conversely, do not compare the shortened CAIP-2 reference with the full result returned by getGenesisHash.

Fail closed on the RPC network

Before loading a buyer signer or making a payment, call getGenesisHash and compare the complete result:
This check catches a wrong cluster and the common error of comparing the RPC result with the shortened x402 identifier.

Native USDC

The tested asset is Circle-issued native USDC on Solana Mainnet: The mint uses the original SPL Token Program, not Token-2022. An x402 payTo value is the merchant wallet address. That wallet’s associated token account for this mint must exist before settlement. Creating the associated token account is a separate setup transaction. The account-creation transaction’s signer pays its SOL network fee and rent-exempt balance. PayAI’s fee payer, discovered from the live facilitator capability response, sponsors the ordinary x402 payment transaction; that sponsorship does not fund merchant account setup.
These constants are also published in the machine-readable integration metadata. For changing facilitator capabilities, always query /supported.
Continue with the x402 Solana Mainnet Express guide.

Primary references