Webhooks for Static wallet
Automate updates for static wallets with webhooks, simplifying payment tracking and enhancing the efficiency of your crypto payment system.
Webhook response
Payment status updates are delivered through webhooks.
For more information on setting up Webhooks, see the Setting up Webhooks.
Set the Webhook URL in the menu Settings → API → Webhook URL. HTTPS (TLS/SSL) is required.
Webhook password - password required to verify the payment signature
Webhook URL - the endpoint where 0xProcessing sends payment status notifications.
Request method: POST
Response Type: JSON
Parameters:
PaymentId
Transaction ID in the 0xProcessing system
Integer
MerchantId
Merchant ID in 0xProcessing system
String
ShopId
Merchant ID in 0xProcessing system
String
Amount
Payment amount in cryptocurrency
Double
AmountUSD
Payment amount in USD equivalent
Double
TotalAmount
Full amount received in the cryptocurrency without fee
Double
TotalAmountUSD
Full amount received in USD equivalent without fee
Double
Currency
Payment currency
String
Not used for this method
String
Status
Payment status
Possible values are:
Success - payment has been executed successfully
String
BillingID
Not used for this method
String
Signature
Checksum to verify the authenticity of the request (to ensure that the request came from 0xProcessing)
String
Insufficient
Not used for this method
Boolean
Test
It indicates whether the payment has been marked as a test payment.
Test payments are not intended for real funds turnover and are not displayed in the merchant account. Do not credit funds on webhooks with the parameter test=true
ClientId
Unique client ID in your system
String
TxHashes
Successful transaction hash(es)
String []
Senders
Sender wallet address(es). Note: Currently works for Tron, BNB, Ethereum, Arbitrum, Avalanche, Polygon, Base, OpBNB, Optimism, HypeEVM, Robinhood chains.
String []
See Test webhooks for instructions
Signature check:
1. A string of the following form must be generated: "PaymentId":"MerchantID"::"Currency":"Password" (WebhookURL link password)
Without quotation marks through a colon.
Example: 12345:Qtfxhgy43::USDT (ERC20):qwerty
2. Hash the resulting string using the MD5 algorithm.
3. Compare the resulting string with the one received in the webhook
4. If the strings are the same, return HTTP Status 200 (Required). Our server expects a response to the webhook within a 3-second timeout period. If the response is not received within these 3 seconds, the system considers the delivery failed.
If the webhook is not delivered successfully, the system retries delivery for a total of 31 attempts, with a 15-second interval between attempts. If the webhook still fails to be delivered, the system sends a notification to the Merchant's account email indicating a problem with the WebhookURL.
Example Webhook JSON:
When processing webhooks, you MUST use the PaymentId parameter from the 0xProcessing webhook as an additional validation factor.
Last updated