Onramp Events

You can expect to receive webhook events whenever an onramp transfer is created or its status is updated.

Types

System Statuses

Status	Description
ONRAMP.TRANSACTION.CREATED	Onramp request created successfully
ONRAMP.STATUS.NOT_INITIATED	Transaction not initiated due to validation error
ONRAMP.STATUS.OPEN_QUOTE	Quote generated and awaiting deposit
ONRAMP.STATUS.IN_REVIEW	Transaction under review by monitoring systems
ONRAMP.STATUS.QUOTE_FAILED	Quote expired before deposit was received
ONRAMP.STATUS.AWAITING_FUNDS	Waiting for fiat deposit with reference ID

Fiat Processing Phase

Status	Description
ONRAMP.STATUS.FIAT_INITIATED	Deposit detected, fiat processing started
ONRAMP.STATUS.FIAT_PENDING	Fiat clearing and validation in progress
ONRAMP.STATUS.FIAT_PROCESSED	Fiat successfully received and validated
ONRAMP.STATUS.FIAT_FAILED	Fiat processing failed (e.g., invalid amount, missing reference, complaince rejection)
ONRAMP.STATUS.FIAT_RETURNED	Fiat returned to sender after failure

Crypto Processing Phase

Status	Description
ONRAMP.STATUS.CRYPTO_INITIATED	Converting fiat to stablecoins
ONRAMP.STATUS.CRYPTO_PENDING	Sending stablecoins on blockchain
ONRAMP.STATUS.CRYPTO_FAILED	Blockchain transaction failed
ONRAMP.STATUS.COMPLETED	Stablecoins delivered to wallet, transaction complete

A failed onramp may be followed by a return event as the fiat is sent back to the sender. See Failed Deposits and Returns for how the statuses progress.

RFI Events

Status	Description
ONRAMP.RFI.OPEN	An RFI case has been opened for this transaction.
ONRAMP.RFI.CLOSED	The RFI case for this transaction has been resolved by the HIFI Compliance team.

To fetch the request itself, call GET /v2/rfis with the transfer’s ID as transferId. See Requests for Information.

Legacy Types:

• ONRAMP.CREATE: Creation for onramps.
• ONRAMP.UPDATE: Updates for onramps.

Legacy event types will be deprecated on Friday, February 13, 2026.

Data

The data object is expected to have the same structure as the response from the Retrieve an onramp endpoint

{
  "eventId": "evt_1957139631552d0e38",
  "eventCategory": "ONRAMP",
  "eventType": "ONRAMP.STATUS.CRYPTO_INITIATED",
  "eventAction": "CRYPTO_INITIATED",
  "data": {
    "transferType": "ONRAMP",
    "transferDetails": {
      "id": "d938f457-5f8f-43d8-9828-134f6112b429",
      "source": {
        "user": {
          "email": "[e-mail]",
          "lastName": "Yang",
          "firstName": "William",
          "businessName": null
        },
        "amount": 1000,
        "userId": "c5a11cdb-2696-4a2e-ac58-3e17fb230288",
        "currency": "usd",
        "accountId": null
      },
      "status": "CRYPTO_INITIATED",
      "receipt": {
        "transactionHash": null
      },
      "createdAt": "2025-03-07T15:29:00.746195+00:00",
      "requestId": "d10d4a8a-4b06-463e-8c12-0ef12c81e961",
      "updatedAt": "2025-03-07T15:29:00.991+00:00",
      "destination": {
        "user": {
          "email": "[e-mail]",
          "lastName": "Yang",
          "firstName": "William",
          "businessName": null
        },
        "chain": "POLYGON_AMOY",
        "amount": null,
        "userId": "c5a11cdb-2696-4a2e-ac58-3e17fb230288",
        "currency": "usdhifi",
        "walletAddress": null
      },
      "developerFee": null,
      "failedReason": null,
      "quoteInformation": null
    }
  },
  "createdAt": "2025-03-07T15:29:01.235Z",
  "timestamp": "2025-03-07T15:29:21.008Z",
  "version": "v2"
}