Webhooks for Static wallet

Automate updates for static wallets with webhooks, simplifying payment tracking and enhancing the efficiency of your crypto payment system.

Webhook Respond

The deposit report is implemented by means of webhooks.

For more information on setting up Webhooks, see the Setting up Webhooks.

Set the Webhook URL in the menu Settings\API\WebhookURL to receive a callback about payment status. Required https (TLS/SSL)

Webhook password - password required to verify the payment signature

Webhook URL - the address in the system from which the payment is made, this address will be used to send updates on the status of payments:

Request method: POST

Response Type: JSON

Parameters:

Name	Description	Type
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
Email	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 callbacks with the parameter test=true
ClientId	Unique client ID in your system	String
TxHashes	Successful transaction hash	String []

If you want to know how to test callbacks? please follow the link

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. Encrypt the resulting string using MD5 algorithm

https://emn178.github.io/online-tools/md5.html

3. Compare the resulting string with the one that came through Webhook

"Signature":"a5510c8c3e657ffd8229813749cd20ec"

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 callback is not delivered successfully, the system repeats at 31 times with an interval of 15 seconds. 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:

                        {
                        "PaymentId":10453,
                        "MerchantId":"Asv0232SSd",
                        "Amount":0.00264765,
                        "TotalAmount":0.00264765,
                        "Currency":"BTC",
                        "Email":"null",
                        "Status":"Success",
                        "Signature":"a5510c8c3e657ffd8229813749cd20ec",
                        "BillingID":"null",
                        "AmountUSD":115.0,
                        "TotalAmountUSD":115.0,
                        "Insufficient":false,
                        "Test":false,
                        "ClientId": "1000",
                        "TxHashes":["0e61e33a0c02204c41ac210c2fcffda4bea4399792acc49479aa8374465ef63a"]
                        }

When processing callbacks, you MUST use the PaymentId parameter from the callback 0xProcessing as an additional validation factor.