Crypto Deposit Webhook
Webhook
POSTCRYPTO_DEPOSIT_UPDATE
externalId. Use this event to automate balance updating and order fulfillment in real time.Event Payload Structure
data object and contains full metadata regarding the detected blockchain transfer:externalId: Unique reference identifier for the deposit (UUID).status: Current processing state of the deposit (e.g., started, pending, successful).amount: Gross amount transferred by the sender (as a decimal string).currency: Cryptocurrency ticker symbol (e.g., BTC, ETH, DOGE).from: Originating sender wallet address (can be null if unavailable).fee: Deposit provision/fee deducted during processing (as a decimal string).transactionHash: On-chain TxID (populated once detected on the blockchain network).createdAt: ISO 8601 UTC timestamp of when the deposit was registered.Status Lifecycle
started: Incoming deposit transaction has been detected on the network.pending: Transaction is waiting for the required number of blockchain network confirmations.waiting-for-verification: Deposit is held pending compliance or automated risk checks.successful: Required confirmations reached; funds have been credited to the partner balance.unsuccessful / banned / rejected-by-reviewer: Deposit failed or was rejected due to AML/compliance rules.Recommended Integration Behavior
successful.externalId to prevent duplicate processing of lifecycle status updates.transactionHash and from address for compliance audit trails.Single Identifier Model
transactionId), incoming deposits rely solely on externalId as their primary lookup key across webhooks and details endpoints.Request
Body Params application/json
Responses
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://your-api-server.com' \
--header 'Content-Type: application/json' \
--data '{
"externalId": "30e07f7a-1c05-4149-a2e2-3717da9d9490",
"status": "successful",
"amount": "1",
"currency": "DOGE",
"from": "0x5fa1f7c5205ee01030b73601bdec63f3e7e677fe",
"fee": "0",
"transactionHash": "0xcedfe0a8db658a000acefbbf5be27c7b0b91edd20caaa2657fdcfcf456446b77",
"createdAt": "2026-09-10T10:50:01.517Z"
}'Response Response Example
{}