Webhooks are the primary method of notification of the services about any kind of update, whether it’s paid or created invoice or created API key.

To create a webhook, open the Webhooks tab of your merchant console and press the Add Webhook button. In the dialog, enter your webhook endpoint and what events should trigger this endpoint.

​
Custom webhook data

To any invoice, you can add custom JSON data, containing any relevant data you wish (i.e. order details). When the invoice is paid, the webhook sent to your URL will contain this data, meaning you do not need to manually store association of invoice ID to your custom data in your database, and you can simply read this data from the webhook we sent, or by requesting invoice info by its ID

​
Structure of a webhook:

{
  "event": "invoice.paid",
  "invoice_id": "65c7e1bf-6a4e-47ba-911e-a7a990b7fb92",
  "merchant_id": "merchant-id-33h2",
  "absolute_amount": 0.10000114,
  "fiat_amount_usd": 0.33,
  "payment_method": "ton",
  "receiving_wallet": "UQBkgmaj5n4kh68Lt-MyM1jfio0HOgonF764hhK164m-sf7u",
  "taken_fee": 0.006600000000000001,
  "invoice_title": "Title",
  "invoice_description": "Description",
  "paid_at": 1745852296,
  "custom_data": {
    "tags": [
      "new-customer",
      "promo"
    ],
    "product": {
      "id": "prod_123",
      "name": "Basic Plan"
    },
    "customer_id": "cust_12345",
    "is_first_time_order": true
  },
  "hmac": "9a71dce906ab6a7d3fcb07f19955f2d2dfd53dd90e7dc57ff2453b39f39cd942"
}