Create a fiat order
Creates the fiat order and returns a hosted URL to send the payer to. KYC and card handling happen on the provider’s pages, so no card data ever reaches your servers or ours.
Poll the order-status endpoint, or rely on the session’s completion webhook, to learn the outcome.
Authorizations
Soft-auth read routes accept x-api-key with a publishable or partner key; money-moving routes require a secret partner key in Authorization: Bearer.
Body
Fiat amount to spend (decimal string).
"100"
Fiat currency code (ISO 4217).
"USD"
Destination crypto asset symbol.
"USDC"
Destination chain code, as used by the fiat provider. Read the supported set from the onramp config endpoint rather than assuming it matches a chain id.
"base"
Payer wallet address (required for checkout).
"0x…"
Payment method code.
"card"
Payer email, forwarded to the hosted KYC flow. Never stored by Hypermid.
Post-payment return URL. Only honoured when its origin is in ONRAMP_RETURN_ORIGINS; otherwise the default is used (open-redirect guard).