🧪Test Webhook

Imitates withdrawal request changes to check your webhooks.

This method requires authorization We're using different API keys for authorizing Invoicing & withdrawal requests.

Make sure you use correct one. This method does not perform any real action. It is supposed to be used as a testing tool.

POST https://api.silus.io/v1/withdrawals/testWebhook

Request body

Name	Type	Definition
amount	string numeric required_without:fiat_amount	Amount to be paid in crypto currency. If there are pennies in the amount, then send them with a separator '.' Example: 10.28 You can omit this parameter and send fiat amount using parameters below
fiat_currency	string required_with:fiat_amount	Fiat currency ISO 4217 code. List of supported fiat currencies
fiat_amount	string numeric required_without:amount	Amount to be paid in fiat currency. If there are pennies in the amount, then send them with a separator '.' Example: 10.28 You can omit this parameter and send crypto amount using amount parameter. When provided, we will automatically convert it to the target crypto currency based on our exchange rates.
order_id*	string min: 1 max: 255 alpha_dash	Order identifier from your system. We will send this ID in every webhook request.
network*	string	Currency identifier in our system
currency*	string	Network identifier in our system
address*	string	The address of the wallet to which the withdrawal will be made
is_subtract*	boolean	Defines where the withdrawal fee will be deducted true - from your balance false - from payout amount, the payout amount will be decreased
additional_data	nullable array|object max: 255 KB	You can send any additional data with this request, it will be returned to you with the webhook.
uuid*	string	UUID of the withdrawal request. Any randomly generated UUID
transaction_id	string	String which will be returned as transaction_id
webhook_url*	string url	Webhook url
status*	string	Status which will be sent in the webhook List of valid statuses

* - mandatory parameter

Request example

curl https://api.silus.io/v1/withdrawals/testWebhook
\-X POST
\-H 'Authorization: Bearer superSecretPrivateKey'
\-H 'Content-Type: application/json'
\-d '{
    "webhook_url": "https://example.com",

    "amount": "500",
    "fiat_currency": "RUB",
    "uuid": "33136e16-3b0b-46af-ab9a-dcbb7f4f7a7d",
    "transaction_id": "test",
    "address": "wallet",
    "order_id": "5",
    "network": "TRON",
    "currency": "TRX",
    "wallet": "test",
    "status": "pending"
}'

Response

Successful response

{
    "request": {
        "headers": {
            "X-Silus-Sign": "6790b59t168d53f8d6466919db921beb2b0312c6da4cf067aaff0a17da865146",
            "X-Silus-Timestamp": "1729082420"
        },
        "body": {
            "id": "33136e16-3b0b-46af-ab9a-dcbb7f4f7a7d",
            "network": "TRON",
            "currency": "TRX",
            "address": "wallet",
            "amount": "500",
            "status": "pending",
            "order_id": null,
            "transaction_id": "test",
            "additional_data": null,
            "created_at": 1729082420,
            "updated_at": 1729082420
        }
    },
    "response": {
        "status": 200,
        "is_ok": true
    }
}

Possible errors

401 Unauthorized

In case of providing invalid API credentials, you will receive response in the following format:

{
  "error": "unauthorized"
}

422 Validation failed

In case of validation error, you will get response in the following format:

{
  "message": "Human friendly error description.",
  
  // This object can have multiple values in case of multiple invalid fields
  // In actual response {fieldName} will be replaced with actual field name
  // for example, "network".
  "errors": {
    "{fieldName}": [
      "Human friendly error description about specific field."
    ]
  }
}