1. Вебхуки
Smerch — API интеграции для мерчантов
  • Быстрый старт
  • Возвраты
  • Песочница, ошибки и go-live
  • Вебхуки (исходящие колбэки)
  • Авторизация и HMAC
  • Балансы и курсы
  • Платежи
  • Выводы (выплаты)
  • Авторизация
    • Проверить, что API отвечает
      GET
  • Балансы
    • Посмотреть балансы
      GET
  • Выводы
    • Создать вывод средств
      POST
    • Посчитать вывод без списания
      GET
    • Получить вывод по UUID
      GET
  • Возвраты
    • Сделать возврат по платежу
      POST
  • Песочница
    • Песочница: симулировать отказ оплаты
      POST
    • Песочница: отказ, затем запоздавшая оплата
      POST
    • Песочница: симулировать успешную оплату
      POST
    • Песочница: симулировать истечение платежа
      POST
  • Платежи
    • Список платежей
    • Создать платёж
    • Найти платёж по вашему external_id
    • Получить платёж по UUID
  • Вебхуки
    • Посмотреть настройки webhook
      GET
    • Задать URL для колбэков
      PUT
    • Журнал доставок webhook
      GET
    • Сменить secret подписи webhook
      POST
    • Отправить тестовый колбэк
      POST
    • Событие: изменился статус платежа
    • Событие: изменился статус вывода
  • Balances
    • Service method
  • Payments
    • Service method
  • Schemas
    • CreatePayoutRequest
    • CreateRefundRequest
    • CreateTransactionRequest
    • CursorMeta
    • ErrorResponse
    • HealthResponse
    • IntegrationBalancesResponse
    • MerchantBalance
    • MerchantPayoutCallback
    • MerchantTransactionCallback
    • PayoutQuoteResponse
    • PayoutResponse
    • RatesResponse
    • RefundResponse
    • StructuredError
    • TransactionResponse
    • TransactionCursorPage
    • ValidationErrorResponse
  1. Вебхуки

Задать URL для колбэков

PUT
/integration/webhook
Куда Smerch будет присылать статусы платежей и выводов.

Request

Authorization
API Key
Add parameter in header
X-Signature
Example:
X-Signature: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢200OK
Настройки обновлены
This response does not have a body.
🟠401Unauthorized
🟠403Forbidden
🟠422Parameter Error
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request PUT '/integration/webhook' \
--header 'X-Signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "url": "http://example.com",
    "enabled": true
}'
Response Response Example
401 - Example 1
{
    "message": "string",
    "error": {
        "code": "string",
        "message": "string",
        "type": "string",
        "status": 0,
        "details": {
            "property1": "string",
            "property2": "string"
        }
    },
    "request_id": "string"
}
Modified at 2026-07-31 12:50:41
Previous
Посмотреть настройки webhook
Next
Журнал доставок webhook
Built with