Let the buyer pick the coin
Opt in so payers can switch crypto on hosted checkout; USD quote stays fixed, coin amount reprices live.
Opt in when creating the invoice
{
"usd_amount": "25.00",
"allow_asset_selection": true,
"asset": "USDC_BASE"
}- Requires
usd_amount(we reprice from dollars when they switch). - Fixed coin
amountcannot use asset selection. - Controlled by you on the API call — the buyer only sees the picker if you enabled it.
Which coins appear
The picker only lists coins you enabled under Settings → Accepted coins. All platform coins are on by default. Disabling a coin hides it from new invoices, payment links, and the checkout picker — and the create API rejects that asset with a clear error.
What happens on switch
- Same USD quote stays (
metadata.usd_amount). - Live price of the new coin is fetched.
expected_amount_atomicupdates.- A new deposit address / QR is minted.
- Previous addresses are archived in metadata for manual tracing.
Selection locks after any payment is detected or the invoice leaves pending.
Card purchases
Untouched card payments still default to USDC on Base. If the buyer picks a coin first, card buys that coin. See Buy with card.