> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hifi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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**  | Failed transaction refunded to user'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.COMPLETED**       | Fiat successfully delivered to bank account |

### 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.

<Warning>
  Legacy event types will be deprecated on Friday, February 13, 2026.
</Warning>

## Data

The data object is expected to have the same structure as the response from the [Retrieve an offramp endpoint](https://docs.hifi.com/api-reference/offramp/retrieve-an-offramp).

```json theme={null}
{
  "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"
}
```