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

# Deposit webhooks

> Receive notifications when fiat or stablecoin deposits complete for your organization.

OpenFX provides a webhook to notify when a deposit is made. Use this webhook to automate deposit processing.

## Webhook payload (fiat)

```json theme={null}
{
  "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
      "reference": "Deposit from XYZ", // Reference / Memo 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)

```json theme={null}
{
  "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
      "reference": null, // Reference / Memo 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
    }
  ]
}
```

<Note>
  Verify every event with the `x-openfx-signature` header before acting on it. See [Webhook authentication](/v2/webhooks/authentication) for verification snippets.
</Note>