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

Событие: изменился статус возврата

Webhook
POST
merchant.refund.status
Исходящий webhook на ваш URL при смене статуса возврата. Только succeeded подтверждает завершение возврата.

Request

Header Params

Body Params application/jsonRequired

Examples

Responses

🟢2XX
Вы приняли событие
This response does not have a body.
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://your-api-server.com' \
--header 'X-Api-Key;' \
--header 'X-Webhook-Id;' \
--header 'X-Webhook-Timestamp;' \
--header 'X-Webhook-Version;' \
--header 'X-Webhook-Key-Id;' \
--header 'X-Webhook-Signature;' \
--header 'X-Webhook-Previous-Key-Id;' \
--header 'X-Webhook-Previous-Signature;' \
--header 'Content-Type: application/json' \
--data '{
    "event": "refund.status_updated",
    "refund": {
        "uuid": "095be615-a8ad-4c33-8e9c-c7612fbf6c9f",
        "transaction_id": "0fec1e58-b197-4052-99cf-2218496c5482",
        "status": "requested",
        "amount_minor": 0,
        "currency": "string",
        "succeeded_at": "2019-08-24T14:15:22.123Z",
        "failed_at": "2019-08-24T14:15:22.123Z"
    }
}'
Modified at 2026-10-20 12:29:50
Previous
Событие: изменился статус рекуррентного мандата
Next
Песочница: создать тестовый платёж
Built with