Offramp Events

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

Types

System Events

Event Type	Description
OFFRAMP.TRANSACTION.CREATED	Offramp request created successfully
OFFRAMP.STATUS.NOT_INITIATED	Transaction not initiated due to validation error
OFFRAMP.STATUS.OPEN_QUOTE	Quote generated and awaiting acceptance
OFFRAMP.STATUS.IN_REVIEW	Transaction under review by monitoring systems
OFFRAMP.STATUS.QUOTE_FAILED	Quote expired or invalid
OFFRAMP.STATUS.AWAITING_FUNDS	Awaiting for crypto deposit

Crypto Processing Events

Status	Description
OFFRAMP.STATUS.CRYPTO_INITIATED	Converting stablecoins, blockchain transaction started
OFFRAMP.STATUS.CRYPTO_PENDING	Blockchain transaction awaiting confirmation
OFFRAMP.STATUS.CRYPTO_PROCESSED	Stablecoins successfully converted
OFFRAMP.STATUS.CRYPTO_FAILED	Blockchain transaction failed
OFFRAMP.STATUS.CRYPTO_RETURNED	Crypto returned on chain to the sender’s wallet

Fiat Processing Events

Status	Description
OFFRAMP.STATUS.FIAT_INITIATED	Fiat payout process started
OFFRAMP.STATUS.FIAT_PENDING	Fiat transaction awaiting settlement
OFFRAMP.STATUS.FIAT_FAILED	Fiat transaction failed
OFFRAMP.STATUS.FIAT_RETURNED	Fiat leg reversed, crypto return not yet delivered
OFFRAMP.STATUS.COMPLETED	Fiat successfully delivered to bank account

A failed offramp is typically followed by return events as the crypto is sent back to the sender. See Failed Payouts and Returns for how the statuses progress.

RFI Events

Status	Description
OFFRAMP.RFI.OPEN	An RFI case has been opened for this transaction.
OFFRAMP.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:

• OFFRAMP.CREATE: Creation for onramps.
• OFFRAMP.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 offramp endpoint.

{
  "eventId": "evt_195713eb5185a84f7d",
  "eventCategory": "OFFRAMP",
  "eventType": "OFFRAMP.STATUS.CRYPTO_INITIATED",
  "eventAction": "CRYPTO_INITIATED",
  "data": {
    "transferType": "OFFRAMP",
    "transferDetails": {
      "id": "07f217dc-f196-4835-ba31-21e1360652d3",
      "source": {
        "user": {
          "email": "[e-mail]",
          "lastName": "Yang",
          "firstName": "William",
          "businessName": null
        },
        "chain": "POLYGON",
        "amount": 100,
        "userId": "c5a11cdb-2696-4a2e-ac58-3e17fb230288",
        "currency": "usdc",
        "walletAddress": "0xa8A642FBA80749318036C97344fC73aE0B64c608"
      },
      "status": "CRYPTO_INITIATED",
      "receipt": {
        "transactionHash": null
      },
      "createdAt": "2025-03-07T15:34:49.454729+00:00",
      "requestId": "45eac735-e4cb-422d-8b5d-fd40af31fbec",
      "updatedAt": "2025-03-07T15:34:49.454729+00:00",
      "destination": {
        "user": {
          "email": "[e-mail]",
          "lastName": "Yang",
          "firstName": "William",
          "businessName": null
        },
        "amount": 0,
        "userId": "c5a11cdb-2696-4a2e-ac58-3e17fb230288",
        "currency": "usd",
        "accountId": "d45ac419-c460-438e-ba63-6ffb706c9683"
      },
      "developerFee": null,
      "failedReason": null,
      "transactionHash": null,
      "quoteInformation": null
    }
  },
  "createdAt": "2025-03-07T15:34:49.913Z",
  "timestamp": "2025-03-07T15:35:00.318Z",
  "version": "v2"
}