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, callgetGenesisHash and compare the complete result:
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.
