Skip to main content
Learn how to listen for stablecoin events that happen on your account. A webhook is a URL on your server where we send payloads for transaction events. For example, if you implement webhooks, we will immediately notify your server with a deposit.success event once a stablecoin deposit is confirmed on-chain. Whenever you receive a webhook notification from us, return a 200 OK to avoid resending the same event again from our server.
Signature verification, retries, source IPs, and local testing work the same way for every Bitnob Business API webhook. They’re covered once, on Webhooks.

​
Webhook

Stablecoin webhooks are fired when a customer sends or receives stablecoin.

​
Deposit stablecoin success

This webhook is fired when a stablecoin deposit is successfully confirmed on the blockchain.
​
string
A unique identifier for this webhook event. Use it to de-duplicate deliveries, since the same event may be sent more than once.
​
string
The webhook event type indicating a successful stablecoin deposit. In this case, it is always ‘deposit.success’.
​
string
The receiving wallet address where the deposit was sent. This belongs to the user or your system.
​
string
The deposit amount represented as a string in the smallest unit of the currency (e.g., ‘9000000’ for 9 USDT).
​
string
The blockchain network where the deposit occurred (e.g., ‘tron’, ‘bsc’, ‘ethereum’).
​
string
The currency received in the deposit, such as ‘USDT’, ‘USDC’, etc.
​
string
The fee amount associated with the deposit, typically ‘0’ for incoming payments.
​
string
The sender’s wallet address that the deposit came from.
​
string
The blockchain transaction hash that uniquely identifies the deposit. Can be used to verify the transaction on a blockchain explorer.
​
string
A unique reference generated for the deposit transaction. Useful for reconciling deposits and tracking them across logs or your system.
​
string
The unique identifier of the transaction in Bitnob. Use it to look up or reconcile the deposit through the API.
​
string
The ISO 8601 timestamp of when the deposit was recorded, indicating when the transaction was detected on the blockchain.

​
Transfer stablecoin success

This webhook is fired when a stablecoin transfer is successfully completed on the blockchain.
The response shares the same payload structure as Deposit Stablecoin Success, without from_address. Refer to the Deposit Stablecoin Success section for field explanations.

​
Transfer stablecoin failed

This webhook is fired when a stablecoin transfer is rejected, reverted, or times out. Held funds return to your balance.
The response shares the same payload structure as Deposit Stablecoin Success, without from_address. Refer to the Deposit Stablecoin Success section for field explanations.