Transfer

Receive transfer status update

Moving funds between a bank and a wallet involves several steps, which HIFI processes asynchronously. By listening to webhook events, you will receive status updates for all the transactions.

Event Type

  • TRANSFER
    • CRYPTO_TO_CRYPTO
    • CRYPTO_TO_FIAT
    • FIAT_TO_CRYPTO

Event Action

  • UPDATE

Sandbox

In Sandbox, we simulate the transaction process and send out a series of webhook messages.

Example webhook event

The data object can be expected to have the same structure as the get endpoint

{
  "eventId": "89c88a4e-803d-4eed-94aa-a66bd9441ebc",
  "eventType": "TRANSFER.CRYPTO_TO_FIAT",
  "eventAction": "UPDATE",
  "timestamp": "2024-06-29T20:03:58.735033+00:00",
  "data": {
  "transferType": "CRYPTO_TO_FIAT",
  "transferDetails": {
    "id": "e6d636d3-8189-4b9b-a1d9-f0a51d269dbf",
    "fee": null,
    "chain": "POLYGON_MAINNET",
    "amount": 1.1,
    "status": "COMPLETED",
    "createdAt": "2024-08-11T03:35:57.637669+00:00",
    "requestId": "d0b937b3-3e9c-4b4f-877d-c6f6128ad054",
    "updatedAt": "2024-08-11T23:36:00.54+00:00",
    "sourceUser": {
      "business_name": null,
      "legal_last_name": "YANG",
      "compliance_email": "[email protected]",
      "legal_first_name": "William"
    },
    "failedReason": null,
    "sourceUserId": "75d7c01f-5f93-4490-8b93-a62fd8020358",
    "conversionRate": {
      "vaildFrom": "2024-08-11T03:35:57.529Z",
      "toCurrency": "usd",
      "vaildUntil": "2024-08-11T03:36:27.529Z",
      "fromCurrency": "usdc",
      "conversionRate": 1
    },
    "sourceCurrency": "usdc",
    "contractAddress": "0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359",
    "destinationUser": {
      "business_name": null,
      "legal_last_name": "YYNG",
      "compliance_email": "[email protected]",
      "legal_first_name": "William"
    },
    "transactionHash": "0x36971178ad6bf64605c934e2f1a8fe705d5b5a307d5fb272a9cdb78b68ddb61f",
    "destinationUserId": "9a493e48-872e-4692-9d3c-23b554bc7ea1",
    "destinationAccount": {
      "id": "dd065da9-ad51-438b-9f72-e8c75b6071d8",
      "iban": null,
      "bank_name": "Bank of Aerica",
      "account_type": "us",
      "bank_country": null,
      "account_number": "483101817874",
      "routing_number": "021000322",
      "account_owner_name": "Wei-Yu, Yang",
      "beneficiary_last_name": null,
      "beneficiary_first_name": null,
      "business_identifier_code": null
    },
    "liquidationAddress": "0xC002A430c7d3a584A1309a2aB48bf373441522cA",
    "destinationCurrency": "usd",
    "destinationAccountId": "dd065da9-ad51-438b-9f72-e8c75b6071d8"
  }
}
}