🧪Test Webhook

Imitates invoice request changes to check your webhooks.

This method requires authorization This method does not perform any real action. It is supposed to be used as a testing tool.

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

Request body

Name	Type	Default	Definition
amount*	string		Amount to be paid. If there are pennies in the amount, then send them with a separator '.' Example: 10.28
fiat_currency*	string		Fiat currency ISO 4217 code. List of supported fiat currencies
order_id*	string min: 1 max: 255 alpha_dash		Order identifier from your system. We will send this ID in every webhook request.
is_payment_multiple	boolean	true
lifetime	int min: 300 max: 43200	3600	The lifespan of the issued invoice (in seconds)
network*	string		Currency identifier in our system
currency*	string		Network identifier in our system
accuracy_payment_percent	numeric min: 0 max: 5	0	Acceptable inaccuracy in payment.
webhook_url*	nullable string url	null	In case you need to have a custom webhook url for that specific order. It has higher priority than the one set in project settings
additional_data	nullable array|object max: 255 KB	null	You can send any additional data with this request, it will be returned to you with the webhook.
paid_crypto_amount	nullable numeric		Paid amount in crypto
paid_fiat_amount	nullable numeric		Paid fiat amount
remaining_crypto_amount	nullable numeric		Remaining amount of crypto to be paid
transactions	array		List of transactions performed during the order. The format can be found on the webhook page
uuid*	string		UUID of the invoice. Any randomly generated UUID
status*	string		Status of the order which will be sent in the webhook List of valid statuses

* - mandatory parameter

Request example

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

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

Response

200 OK

{
    "request": {
        "headers": {
            "X-Silus-Sign": "77133e051ec391295390e9f8703854b0d0e004421dfdd476cd8fed2d0924a3",
            "X-Silus-Timestamp": "1729082675"
        },
        "body": {
            "id": "33136e16-3b0b-46af-ab9a-dcbb7f4f7a7d",
            "amount": "500",
            "crypto_amount": 3130.8705,
            "remaining_crypto_amount": 3130.8705,
            "paid_fiat_amount": null,
            "paid_crypto_amount": null,
            "merchant_fiat_amount": 0,
            "merchant_crypto_amount": 0,
            "fiat_currency": "USD",
            "is_payment_multiple": false,
            "status": "pending",
            "currency": "TRX",
            "network": "TRON",
            "wallet": "TXxDFLLE9uhZtLRwgqUYTyzZuT2F5hC4ZV",
            "created_at": 1729082675,
            "expires_at": 1729086275,
            "pay_url": "https://pay.silus.io/33136e16-3b0b-46af-ab9a-dcbb7f4f7a7d",
            "additional_data": null,
            "transactions": []
        }
    },
    "response": {
        "status": 200,
        "is_ok": true
    }
}

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 case in case of multiple invalid fields
  // In actual response {fieldName} will be replace with actual field name
  // for example, "network".
  "errors": {
    "{fieldName}": [
      "Human friendly error description about specific field."
    ]
  }
}

401 Unauthorized

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

{
  "error": "unauthorized"
}