← Home
—/hyax-api/trpc/crypto.updateCryptoSettings

Set up USDC payments

Hyax settles native Circle USDC straight to a wallet you control — no processor, no platform custody, no payout schedule. Turn it on under Settings → Team → Payments: paste an EVM receiving address (`0x` followed by 40 hex characters) and enable the toggle. Enabling without a valid address is rejected, so the gateway can never appear at checkout with nowhere to send funds. The same address receives on every supported network. Once enabled, USDC shows up in the checkout payment dialog alongside Stripe and PayPal, and confirmed payments create an order with `paymentPlatform: USDC_BASE` and the transaction hash as `externalOrderId`.

Base URL: https://platform.hyax.com · Replace YOUR_API_KEY with your team API key.

Request 

# This route is session-based, multipart, or provider-specific.
# Inspect: apps/web/server/routes/hyax-api/

Response 

Supported networks — native Circle USDC, 6 decimals

  Base (default)   chainId 8453    0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913    3 confirmations    gas in ETH
  Arbitrum One     chainId 42161   0xaf88d065e77c8cC2239327C5EDb3A432268e5831    5 confirmations    gas in ETH
  Optimism         chainId 10      0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85    3 confirmations    gas in ETH
  Polygon          chainId 137     0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359   30 confirmations    gas in POL
  Avalanche        chainId 43114   0xB97EF9Ef8734C71904D8002F8b6Bc66Dd9c48a6E    3 confirmations    gas in AVAX

Ethereum mainnet is intentionally excluded (gas cost).

Payment flow

  1. crypto.createCryptoCheckoutSession   exact amount + recipient + network
  2. Buyer sends that exact USDC amount from any wallet
  3. crypto.submitCryptoPayment           attach the transaction hash
  4. crypto.getCryptoPaymentStatus        poll until status is PAID

Self-hosting

  Public RPCs are used by default. Override per network with BASE_RPC_URL,
  ARBITRUM_RPC_URL, OPTIMISM_RPC_URL, POLYGON_RPC_URL, AVALANCHE_RPC_URL.
  Tune required confirmations with CRYPTO_MIN_CONFIRMATIONS (Base),
  ARBITRUM_MIN_CONFIRMATIONS, OPTIMISM_MIN_CONFIRMATIONS,
  POLYGON_MIN_CONFIRMATIONS, AVALANCHE_MIN_CONFIRMATIONS.