Skip to content

OpenFX provides a webhook to notify when a deposit is made. This webhook can be used to automate deposit processing.

Webhook Payload (Fiat)

{
  "eventId": "ba8dbff0-6d7b-45b1-961b-84de15d9158f", // Unique identifier for the webhook event
  "type": "deposits", // Type of the webhook event
  "message": "Completed Deposits", // Message of the webhook event
  "timestamp": "2025-03-19T10:39:52.891Z" // Timestamp of the webhook event
  "data": [
    {
      "id": "d67191dc-8bab-4335-96fa-85d59d0168ec", // Unique identifier for the deposit
      "orgId": "4638f9df-8a2b-44f4-a31c-d0477fd03e87", // Unique identifier for the organization
      "amount": 10000, // Amount of the deposit
      "currency": "USD", // Currency of the deposit
      "status": "COMPLETED", // Status of the deposit
      "network": "FIAT", // Network of the deposit
      "referenceId": "8ff46b975742419688dddb7b0b46ab7a", // Reference ID of the deposit, if exists
      "comments": "Fedwire deposit", // Comments on the deposit, if exists
      "transactionHash": null, // Transaction Hash of the deposit, if exists
      "completedAt": "2025-03-19T10:39:50.618Z", // Timestamp of the deposit
    }
  ]
}

Webhook Payload (Stablecoin)

{
  "eventId": "ba8dbff0-6d7b-45b1-961b-84de15d9158f", // Unique identifier for the webhook event
  "type": "deposits", // Type of the webhook event
  "message": "Completed Deposits", // Message of the webhook event
  "timestamp": "2025-03-19T10:39:52.891Z" // Timestamp of the webhook event
  "data": [
    {
      "id": "d67191dc-8bab-4335-96fa-85d59d0168ec", // Unique identifier for the deposit
      "orgId": "4638f9df-8a2b-44f4-a31c-d0477fd03e87", // Unique identifier for the organization
      "amount": 10000, // Amount of the deposit
      "currency": "USDT", // Currency of the deposit
      "status": "COMPLETED", // Status of the deposit
      "network": "ETHEREUM", // Network of the deposit
      "referenceId": null, // Reference ID of the deposit, if exists
      "comments": null, // Comments of the deposit, if exists
      "transactionHash": "0x5c504ed432cb51138bcf09aa5e8a410dd4a1e204ef84bfed1be16dfba1b22060", // Transaction Hash of the deposit, if exists
      "completedAt": "2025-03-19T10:39:50.618Z", // Timestamp of the deposit
    }
  ]
}