Вебхук пополнения депозита

Вебхук, отправляемый мерчанту при пополнении депозита мерчанта.

Когда Paylov пополняет A2C, Paynet или Munis депозит вашего мерчанта, на ваш endpoint мерчанта отправляется вебхук merchant.deposit. Вебхук отправляется только для входящих пополнений.

Важно

Чтобы получать вебхуки, сначала webhook URL, username и password должны быть привязаны к вашему мерчанту на стороне Paylov. Отправьте эти данные в Paylov — пока они не привязаны, вебхук не отправляется.

Запрос

POST <WEBHOOK_URL>

Заголовки

Authorization: Basic base64(username:password)
Content-Type: application/json

Запрос отправляется как JSON-RPC 2.0 notification.

Пример запроса

{
  "jsonrpc": "2.0",
  "method": "merchant.deposit",
  "params": {
    "id": "6f1c2b7e-3d4a-5b8c-9e0f-1a2b3c4d5e6f",
    "merchant": "125",
    "type": "a2c",
    "amount_in_tiyin": 10000000,
    "create_time": 1767162243
  }
}

Поле	Тип	Описание
id	string	Уникальный ID пополнения (UUID)
merchant	string	ID мерчанта
type	string	Тип депозита: a2c, paynet или munis
amount_in_tiyin	integer	Сумма пополнения в тийинах
create_time	integer	Время пополнения, Unix timestamp в секундах

Формат суммы

10000000 означает 100 000.00 UZS.

Ожидаемый ответ

Верните любой HTTP статус 2xx. Тело ответа не проверяется.

Повторные отправки

Если ваш endpoint вернёт статус не 2xx или не ответит (таймаут подключения 5s, таймаут чтения 30s), вебхук будет повторно отправлен до 3 раз с интервалом 60 секунд. Один и тот же вебхук может прийти несколько раз — используйте id для отсева дубликатов.