← 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 network — native Circle USDC, 6 decimals

  Base   chainId 8453    0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913    3 confirmations    gas in ETH

Other networks are not available for new checkouts.

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.