Skip to main content
Transactions are the actual movement of value HIFI executes on a user’s behalf - converting fiat to stablecoins and back, moving stablecoins between wallets, converting between stablecoins, and moving stablecoins across chains.

​
Resources

  • Onramps — convert fiat into stablecoins, landing in a HIFI Wallet or External Wallet.
  • Offramps — convert stablecoins into fiat, paid out to an External Account or External Card.
  • Onchain Transfer — move stablecoins between wallets on the same chain, to one recipient or many at once (batch).
  • Swap — convert between stablecoins (e.g. USDC → USDT).
  • Bridge — move a stablecoin from a wallet on one chain to a wallet on a different chain.

​
Two flow shapes

Onramp, Offramp, Swap, and Bridge are quote-then-accept: creating one returns a quote (rate, fees, expiry) without moving any funds; a separate accept call executes it. Onchain Transfer (single and batch) has no quote step — it executes immediately on creation, and you track progress via GET or webhooks.

​
Common Conventions

  • Idempotency: every create call takes a client-supplied requestId (UUID). Reusing one with the same payload returns the existing transaction instead of creating a duplicate; reusing one with a different payload is rejected with RESOURCE_CONFLICT (409).
  • Status & webhooks: every resource has a status field and its own status enum. Subscribe to webhooks to track progress asynchronously instead of polling — each resource emits a CREATED event plus one event per status value (e.g. ONRAMP.STATUS.COMPLETED).
  • error / errorDetails: resources that can fail return a user-facing error and errorDetails once in a failed/terminal state. Provider names never appear in these fields.

​
Transaction Monitoring

Every transaction goes through HIFI’s compliance monitoring. While a transaction is being reviewed, its status remains IN_REVIEW - it only moves on to the next status once compliance clears it. If HIFI’s compliance team needs more information to clear a transaction, we will send a Request for Information (RFI).

​
Getting Help

  • 📧 Email: support@hifi.com
  • 💬 Slack: Message us in our shared Slack channel
  • Onramps — Fund a wallet from fiat
  • Offramps — Pay out stablecoins to fiat
  • Onchain Transfer — Move stablecoins between wallets
  • Swap — Convert between stablecoins
  • Bridge — Move a stablecoin across chains