Веб-хуки (WebHooks)

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

Если веб-хуки включены, планировщик задач будет отправлять их POST запросом на адрес хоста, который был указан в панеле управления в разделе "Настройки приложения" — "Настройка WebHooks". Секретный ключ будет выслан в HTTP заголовке X-Authorization.

Пример запроса (изменение статуса двух заявок на обмен, добавление отзыва, регистрация пользователя):

POST /call-handler 
Host: myhost.com 
Header: X-Authorization ***** 
Fields: web_hooks[json] 

Вместо отправки множества запросов, будет отправлен только один запрос, содержащий единый массив веб-хуков за определенный промежуток времени, который равен интервалу планировщика задач.

Пример содержимого параметра web_hooks:

{ 
    "1":[ 
        [85,"127.0.0.1","US","126f9f9cdd26cccb25da2f078cda6536",0,"ru",8,0,"","",{"0":"U6375940","1":"U675474747127","6":"[email protected]"},40,77,"PMUSD","USD","USD","ADVCUSD",1.0201,1,100,98.03,2,2,1,0,0,0,1585636634], 
        [84,"127.0.0.1","GB","9f4ed52526aac96b417f6303998faa78",0,"ru",1,0,"","",{"1":"U675474747127","6":"[email protected]"},76,77,"BALANCEUSD","USD","USD","ADVCUSD",1,1,100,100,2,2,1,0,0,0,1585553977] 
    ], 
    "6":[ 
        [105,"127.0.0.1","RU",1,"ru","[email protected]","Сергей","Все супер!!!и быстро главное.",1585635787] 
    ], 
    "0":[ 
        [40,"127.0.0.1","IT",1,"holaamigo","[email protected]","",1585553893] 
    ] 
}

Ключем является числовой идентификатор (тип) веб-хука, значение состоит из массива веб-хуков.

Пример успешного ответа:

{ 
    "success":true, 
    "result":200 
}

После успешной обработки запроса, необходимо возвращать код 200.

Пример неуспешного ответа:

{ 
    "success":false, 
    "result":false 
}

Ответ сервера должен быть в формате json.

Настройки событий расположены в панеле управления в разделе "Настройки приложения" — "Настройка WebHooks".

Отправляется при регистрации пользователей, а так же во время создания, удаления или активации/деактивации через панель управления.

Обработка ответа:

Отправляется при создании заявки на обмен и изменении её статуса мерчантом, а так же во время удаления или изменения статуса через панель управления.

Обработка ответа:

Идентификаторы обязательных к заполнению полей на странице обмена:

Идентификаторы мерчантов обработки входящих платежей:

Идентификаторы мерчантов обработки исходящих платежей:

Идентификаторы статуса заявок на обмен:

Отправляется при создании запроса на верификацию, а так же во время создания, удаления или активации/деактивации через панель управления.

Обработка ответа:

Отправляется при создании заявки на запрос резерва, а так же во время создания, удаления или активации/деактивации через панель управления.

Обработка ответа:

Отправляется при покупке инвестиционного пакета и изменении его статуса, а так же во время создания и удаления через панель управления.

Обработка ответа:

Отправляется при создании правила на блокировку реквизитов, удалении и активации/деактивации через панель управления.

Обработка ответа:

Отправляется при добавлении отзыва, а так при создании, удалении и активации/деактивации через панель управления.

Обработка ответа: