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