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

# Deposit Received

> Sent when a crypto deposit reaches your account balance.

A deposit is the one movement on your account that does not begin with an API call: it starts on a
chain. There is no request of yours to correlate it with, so `transactionHash` is the identifier
to reconcile against — it is also the only one you can check for yourself on a block explorer.

`amountOnChain` is what the chain moved. `amountCredited` is what reached your balance, after the
deposit fee. Reconcile the first against the explorer and the second against your statement.

```json Webhook Payload theme={null}
{
  "event": "deposit.received",
  "version": "3.0",
  "eventId": "f0b1c2d3-4e5f-6071-8293-a4b5c6d7e8f9",
  "sign": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2",
  "data": {
    "reference": "DEP7F3A9C1B04",
    "transactionHash": "0x4f2a9c7e1b8d05a3f6c2e9b7d410a8c53f1e6b2d9a7c40f8e3b5d1a6c9e2f704",
    "fromAddress": "0x9c4e7a2b5d8f01a3c6e9b2d5f8a1c4e7b0d3f6a9",
    "toAddress": "0x1a4d7f0b3e6a9c2f5b8e1d4a7c0f3b6e9d2a5c8f",
    "token": "USDT",
    "network": "BEP20",
    "amountOnChain": 500,
    "amountCredited": 497.5,
    "currency": "USD",
    "appId": "A1B2C3D4E5F6G7H8",
    "timestamp": "2026-10-22T09:14:07Z"
  }
}
```

```json 200 theme={null}
{}
```

> [!NOTE]
>
> The same deposit is never credited twice: a redelivery of this event carries the same
> `transactionHash`, so treat that hash as the idempotency key on your side.


## OpenAPI

````yaml v3/openapi.json webhook deposit.received
openapi: 3.1.0
info:
  title: FYATU API v3
  description: >-
    FYATU API v3 with JWT authentication for Collections, Payouts, and Card
    Issuing.
  version: 3.0.0
  contact:
    name: FYATU Support
    url: https://fyatu.com
    email: support@fyatu.com
servers:
  - url: https://api.fyatu.com/api/v3
    description: Production
security: []
tags:
  - name: Authentication
    description: JWT token management endpoints
  - name: Account
    description: Business account, wallet, and address management
  - name: Collections
    description: Accept payments from customers via checkout sessions
  - name: Refunds
    description: Issue refunds for completed collections
  - name: Payouts
    description: Send money to Fyatu account holders
  - name: Cardholders
    description: Cardholder management for card issuing programs
  - name: Cards
    description: Issue, fund, freeze, and manage virtual cards
  - name: Webhooks
    description: Webhook configuration and management
paths: {}

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.