> For the complete documentation index, see [llms.txt](https://docs.aquanow.io/cams/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.aquanow.io/cams/webhooks/funding-request.md).

# Funding Request

### Funding Request Webhook

The Funding Request webhook keeps the integration in sync with the full lifecycle of a deposit made against a funding request from the moment it's detected on-chain, through confirmation and any required compliance review, to final settlement or failure. Rather than polling the Funding Request API, subscribe to this webhook to receive real-time status updates as they happen.

This message type (`FUNDING_REQUEST`) replaces the legacy `FUNDING_REQUEST_DEPOSIT_CONFIRMING` and `FUNDING_REQUEST_DEPOSIT_RECEIVED` webhooks. 

A single funding request may receive multiple `FUNDING_REQUEST` messages over its lifetime as it progresses through these stages; the current stage is always identified by the pair of fields `transactionStatus` and `statusReason` in the payload.

#### Statuses

| transactionStatus | statusReason                | Meaning                                                                                        |
| ----------------- | --------------------------- | ---------------------------------------------------------------------------------------------- |
| `CONFIRMING`      | `Deposit Confirming`        | Deposit detected on-chain, awaiting blockchain confirmations                                   |
| `CONFIRMING`      | `Deposit Under Review`      | Deposit flagged for manual compliance review                                                   |
| `PROCESSING`      | `Deposit Completed`         | Deposit confirmed and being processed toward the beneficiary                                   |
| `PROCESSING`      | `Conversion Processed`      | Currency conversion for the deposit has been executed                                          |
| `COMPLETED`       | `Funding Request Completed` | Funds credited to the beneficiary account.                                                     |
| `FAILED`          | `Deposit Failed`            | The on-chain deposit could not be completed due to Blockchain deposit failure terminal failure |
| `FAILED`          | `Deposit Rejected`          | The deposit was rejected during compliance review                                              |

`COMPLETED` and `FAILED` are terminal states so no further `FUNDING_REQUEST` messages will be sent for that deposit once one of these is received.

{% openapi-webhook spec="fr-v1" name="fundingRequest" method="post" %}
[fr-v1](https://4401d86825a13bf607936cc3a9f3897a.r2.cloudflarestorage.com/gitbook-x-prod-openapi/raw/9549fdc58abd5c6c3adaa3113e05bf9a2fef6f9fc4567abe493df901ef0484a5.json?X-Amz-Algorithm=AWS4-HMAC-SHA256\&X-Amz-Content-Sha256=UNSIGNED-PAYLOAD\&X-Amz-Credential=dce48141f43c0191a2ad043a6888781c%2F20260921%2Fauto%2Fs3%2Faws4_request\&X-Amz-Date=20260921T182411Z\&X-Amz-Expires=172800\&X-Amz-Signature=c0e7d44d3dab14ce9b715a1413feabfa67fb2121fef2e3ea7bb4312e471233bc\&X-Amz-SignedHeaders=host\&x-amz-checksum-mode=ENABLED\&x-id=GetObject)
{% endopenapi-webhook %}