Веб-хуки (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".

Тип # 0. Изменение статуса пользователей

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

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

#Описание индекса
0Идентификатор
1IP адрес
2Двухбуквенный код страны
3Статус (активен: 1/0, удален: -1)
4Логин
5Электронная почта
6Токен подтверждения регистрации
7Дата регистрации в формате Unix Timestamp
Тип # 1. Изменение статуса заявок на обмен

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

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

#Описание индекса
0Идентификатор
1IP адрес
2Двухбуквенный код страны
3Токен
4Идентификатор статуса
5Двухбуквенный код языка
6Идентификатор мерчанта входящих платежей
7Идентификатор мерчанта исходящих платежей
8Идентификатор транзакции о подтверждении оплаты
9Идентификатор транзакции о подтверждении выплаты
10Массив из идентификаторов обязательных к заполнению полей на странице обмена
11Идентификатор отдаваемой валюты
12Идентификатор получаемой валюты
13Строка идентификатор отдаваемой валюты
14Строка идентификатор получаемой валюты
15Код отдаваемой валюты в стандарте ISO 4217
16Код получаемой валюты в стандарте ISO 4217
17Курс отдаваемой валюты
18Курс получаемой валюты
19Отдаваемая сумма
20Получаемая сумма
21Количество знаков после запятой отдаваемой валюты
22Количество знаков после запятой получаемой валюты
23Идентификатор пользователя
24Сумма бонуса
25Идентификатор реферала
26Сумма реферального вознаграждения
27Дата создания в формате Unix Timestamp

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

#Описание идентификатора
0Реквизиты отдаваемой валюты
1Реквизиты получаемой валюты
2Тег назначения
3Имя
4Среднее имя
5Фамилия
6Электронная почта
7Номер телефона
8Номер паспорта
9Страна
10Город
11Адрес
12Кодовая фраза
13URL адрес
14Комментарий
15Дата
16Время
17Telegram
18Skype
19Viber
20Whatsapp
21Messenger
22Discord
23Snapchat

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

#Описание идентификатора
0Ручная обработка платежа
1Баланс пользователя
2Advanced Cash
3Alikassa
4Coinpayments
5LiqPay
6PayPal
7Payeer
8Perfect Money
9Qiwi
10Web Money
11Yandex Money
12Exmo
13Livecoin
14LocalCAG
154Bill

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

#Описание идентификатора
0Ручная обработка платежа
1Баланс пользователя
2Кастомный мерчант

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

#Описание идентификатора
0Ожидает оплаты
1Оплачена
2Приостановлена
3Отменена
4Выполнена
Тип # 2. Изменение статуса запроса на верификацию

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

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

#Описание индекса
0Идентификатор
1Токен
2Статус (активен: 1/0, удален: -1)
3Идентификатор пользователя
4Логин пользователя
5Электронная почта пользователя
6Тип документа
7Номер документа
8Имя
9Среднее имя
10Фамилия
11Дата рождения
12Номер телефона
13Страна
14Город
15Адрес
16Почтовый индекс
17Дата создания в формате Unix Timestamp
Тип # 3. Изменение статуса заявки на запрос резерва

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

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

#Описание индекса
0Идентификатор
1IP адрес
2Двухбуквенный код страны
3Токен
4Статус (активен: 1/0, удален: -1)
5Двухбуквенный код языка
6Идентификатор валюты
7Строка идентификатор валюты
8Код валюты в стандарте ISO 4217
9Количество знаков после запятой валюты
10Сумма
11Электронная почта
12Дата создания в формате Unix Timestamp
Тип # 4. Изменение статуса инвестиционных пакетов

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

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

#Описание индекса
0Идентификатор
1Статус (активен: 1/0, удален: -1)
2Идентификатор пользователя
3Логин пользователя
4Электронная почта пользователя
5Сумма вклада
6Сумма начислений
7Процентная ставка за весь период
8Период
9Дата открытия в формате Unix Timestamp
10Дата последнего начисления в формате Unix Timestamp
11Дата закрытия в формате Unix Timestamp
Тип # 5. Изменение статуса заблокированных реквизитов

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

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

#Описание индекса
0Идентификатор
1Статус (активен: 1/0, удален: -1)
2Идентификатор валюты
3Строка идентификатор валюты
4Название кода валюты в стандарте ISO
5Реквизиты
6Причина блокировки
Тип # 6. Изменение статуса отзыва

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

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

#Описание индекса
0Идентификатор
1IP адрес
2Двухбуквенный код страны
3Статус (активен: 1/0, удален: -1)
4Двухбуквенный код языка
5Электронная почта
6Имя
7Текст
8Дата создания в формате Unix Timestamp

График работы пн. — вс. 08:00 — 20:00 (GMT+03:00)

Сделано с от Exchanger CMS © 2019 - 2020

Telegram чатОбратная связь

Мы в социальных сетях