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. An email with next steps has been sent by the HIFI Compliance team. |
| OFFRAMP.RFI.CLOSED | The RFI case for this transaction has been resolved by the HIFI Compliance team. |
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": "william.yang@hifibridge.com",
"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": "william.yang@hifibridge.com",
"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"
}