Crypto Deposit Order Notification

DEPOSIT_ORDER_NOTIFICATION — progress on a plain wallet deposit, one that does not sit behind a collection
order. Deduplicate on eventId.

Reading the event

Branch on data.status together with data.whiteListStatus:

Situation	How it looks	What you do
Payer details needed, first submission	`status = PROCESSING`, `whiteListStatus = init`	Submit the Travel Rule details
Review rejected, resubmit	`status = PROCESSING`, `whiteListStatus = rejected`	Correct the details and submit again
Deposit fully complete	`status = SUCCESS`, normally `whiteListStatus = approved`	Book it

Answer a gate with POST /v1/wallet/deposit-whitelist/transactions/{transactionId}/submit.

SUCCESS means the deposit is finished, including auto-collection into the main account where that is
switched on. A gated deposit cannot reach SUCCESS before the whitelist has cleared.

whiteListStatus is null for deposits that are not subject to the whitelist; those produce only the
SUCCESS event.

There is no separate whitelist webhook, and whitelist approval is not announced on its own — wait for this
event at status = SUCCESS.

Guide: Wallet · Deposit whitelist

Request

Header Params

Body Params application/json

Example

{
  "eventId": "24",
  "eventType": "DEPOSIT_ORDER_NOTIFICATION",
  "referenceId": "6",
  "status": "SUCCESS",
  "timestamp": 1757923984621,
  "data": {
    "transactionId": "",
    "transactionHash": "",
    "transactionType": "DEPOSIT",
    "amount": 1.0,
    "currency": "USDT",
    "network": "ETH",
    "fromAddress": "",
    "walletId": "",
    "walletName": "",
    "status": "",
    "timestamp": 1757923984621,
    "whiteListStatus": "approved"
  }
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Crypto Deposit Order Notification