| Интерфейс автоматической конфигурации позволяет организовать моментальную настройку программой установки скрипта, приобретенного пользователем, интеграции пользовательского аккаунта с функциями данного скрипта. Этот интерфейс позволяет добавлять сайты в сервис обработки платежей JetSwap Merchant, а также автоматические API-интерфейсы Например, программа установки скрипта казино, работающего с кредитами и деньгами JetSwap, использующая данный интерфейс, может добавить пользовательский сайт в систему обработки платежей JetSwap Merchant со всеми необходимыми настройками (для включения возможности приема платежей), зарегистрировать новый API-интерфейс для выплаты выигрышей, сохранить все нужные данные в БД, затем выключить интерфейс автоматической конфигурации в целях безопасности пользовательского аккаунта, а все, что нужно будет сделать пользователю - ввести свой логин и временный код автоматизации (выданный нашим сайтом) в программе установки (причем эти данные не будут сохранены, что опять же повышает безопасность, да и код автоматизации все время меняется).
- Включение автоматической конфигурации
Прежде, чем пользователь сможет использовать этот интерфейс, его нужно включить. Для этого пользователь должен перейти по ссылке для активации автоматического интерфейса и передать вашей программе код активации, выданный после включения функции автоматической конфигурации.
- Функция 1. Добавление нового сайта для приема платежей
Данная функция позволяет добавить новый сайт в систему обработки платежей JetSwap Merchant. Назначение полей описано кратно, более подробное описание вы найдете в руководстве по сервису обработки платежей.
Форма запроса должна иметь следующие параметры:
Action: http://go.jetswap.com/api
Method: POST
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
| PAY_INTERFACE | Да | Должен принимать значение 4.
| | PAY_USER | Да | Логин продавца в системе JetSwap
| | PAY_TIME | Да | Время совершения операции в формате UNIX_TIMESTAMP. Может отклоняться от времени сервера не более чем на 10 минут (время на сервере московское).
| | PAY_CODE | Да | Контрольная подпись запроса (формирование описано ниже)
| | fnc | Да | Должен принимать значение 1.
| | name | Да | Название вашего сайта.
| | result | Да | URL для отправки сообщения о платеже
| | success | Да | URL удачного выполнения платежа.
| | successm | Да | Метод отправки Success URL: GET/POST
| | middle | Да | URL неавтоматического выполнения платежа
| | middlem | Да | Метод отправки Middle URL GET/POST
| | fail | Да | URL ошибки выполнения платежа
| | failm | Да | Метод отправки Fail URL: GET/POST
| | email | Нет | E-Mail продавца для отправки результатов платежа
| | allowcurl | Нет | Разрешить использовать Success URL, Middle URL и Fail URL, передаваемые в форме запроса платежа 0/1
| | code | Да | Код для проверки достоверности сообщения о платеже(PAY_KEY)
| | ps | Нет | Включить платежи из внешних платежных систем 0/1
|
После обработки запроса сервер вернет ответ:
Вариант ответа |
Описание |
| !ID | Операция прошла успешно, ID - идентификатор зарегистрированного сайта в системе JetSwap Merchant (параметр PAY_SITE). Например, !123.
|
| 1 | Пользователь PAY_USER в системе не зарегистрирован.
|
| 2 | Код PAY_CODE неверен
|
| 3 | Время PAY_TIME не соответствует предъявляемым требованиям
|
| ?PARAMETER | Один из обязательных параметров не задан или принимает недопустимые значения. Вместо PARAMETER будет показано название этого параметра, например ?result.
|
| 5 | Переменная PAY_INTERFACE задана неверно или отсутствует
|
| 6 | Интерфейс AutoConf не активизирован для этого пользователя
|
| Любое другое | Внутренняя ошибка сервера
|
Электронная подпись запроса(Параметр PAY_CODE)
Для проверки подлинности запроса используется электронная подпись, которая передается обработчику в переменной PAY_CODE. Она формируется с использованием функции md5:
PAY_CODE=md5("PAY_INTERFACE::PAY_USER::PAY_TIME::fnc::PAY_KEY")
где PAY_KEY - код автоматизации, полученный при активации интерфейса автоматической конфигурации, другие переменные описаны выше в этом пункте. Символы "::" не заменяются и служат разделителями переменных.
- Функция 2. Добавление нового API-интерфейса
Данная функция позволяет добавить новый API-интерфейс. Назначение полей описано кратно, более подробное описание вы найдете в руководстве по API-интерфейсам.
Форма запроса должна иметь следующие параметры:
Action: http://go.jetswap.com/api
Method: POST
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
| PAY_INTERFACE | Да | Должен принимать значение 4.
| | PAY_USER | Да | Логин продавца в системе JetSwap
| | PAY_TIME | Да | Время совершения операции в формате UNIX_TIMESTAMP. Может отклоняться от времени сервера не более чем на 10 минут (время на сервере московское).
| | PAY_CODE | Да | Контрольная подпись запроса (формирование описано ниже)
|
| fnc | Да | Должен принимать значение 2
| | name | Да | Название интерфейса
|
| ip | Нет | Разрешенные IP-адреса
|
| op | Да | Список разрешенных операций. Формат списка: каждая операция может принимать значение 0 (запрещено) или 1 (разрешено). Последовательность операций: перевод средств, перевод кредитов, проверка баланса, служебное поле (должно принимать значение 0), управление сайтами. Например, 00100 - разрешает проверку баланса, 11000 - разрешает перевод денег и кредитов и запрещает проверку баланса. Обязательно должны быть переданы все пять управляющих чисел от 00000 до 11101. Четвертное число всегда должно быть 0.
|
| code | Да | Код, который используется при формировании контрольной подписи запроса к этому интерфейсу
|
После обработки запроса сервер вернет ответ:
Вариант ответа |
Описание |
| !ID | Операция прошла успешно, ID - идентификатор зарегистрированного API-интерфейса (параметр PAY_API). Например, !123.
|
| 1 | Пользователь PAY_USER в системе не зарегистрирован.
|
| 2 | Код PAY_CODE неверен
|
| 3 | Время PAY_TIME не соответствует предъявляемым требованиям
|
| ?PARAMETER | Один из обязательных параметров не задан или принимает недопустимые значения. Вместо PARAMETER будет показано название этого параметра, например ?result.
|
| 5 | Переменная PAY_INTERFACE задана неверно или отсутствует
|
| 6 | Интерфейс AutoConf не активизирован для этого пользователя
|
| Любое другое | Внутренняя ошибка сервера
|
Электронная подпись запроса(Параметр PAY_CODE)
Для проверки подлинности запроса используется электронная подпись, которая передается обработчику в переменной PAY_CODE. Она формируется с использованием функции md5:
PAY_CODE=md5("PAY_INTERFACE::PAY_USER::PAY_TIME::fnc::PAY_KEY")
где PAY_KEY - код автоматизации, полученный при активации интерфейса автоматической конфигурации, другие переменные описаны выше в этом пункте. Символы "::" не заменяются и служат разделителями переменных.
- Функция 3. Отключение AutoConf
Данная функция позволяет отключить интерфейс автоматической конфигурации пользовательского аккаунта после выполнения всех нужных для программы установки действий. Обычно пользователи это делать забывают, так что лучше о них позаботиться.
Форма запроса должна иметь следующие параметры:
Action: http://go.jetswap.com/api
Method: POST
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
| PAY_INTERFACE | Да | Должен принимать значение 4.
| | PAY_USER | Да | Логин продавца в системе JetSwap
| | PAY_TIME | Да | Время совершения операции в формате UNIX_TIMESTAMP. Может отклоняться от времени сервера не более чем на 10 минут (время на сервере московское).
| | PAY_CODE | Да | Контрольная подпись запроса (формирование описано ниже)
|
| fnc | Да | Должен принимать значение 3
|
После обработки запроса сервер вернет ответ:
Вариант ответа |
Описание |
| 0 | Операция прошла успешно, интерфейс выключен.
|
| 1 | Пользователь PAY_USER в системе не зарегистрирован.
|
| 2 | Код PAY_CODE неверен
|
| 3 | Время PAY_TIME не соответствует предъявляемым требованиям
|
| ?PARAMETER | Один из обязательных параметров не задан или принимает недопустимые значения. Вместо PARAMETER будет показано название этого параметра, например ?result.
|
| 5 | Переменная PAY_INTERFACE задана неверно или отсутствует
|
| 6 | Интерфейс AutoConf не активизирован для этого пользователя
|
| Любое другое | Внутренняя ошибка сервера
|
Электронная подпись запроса(Параметр PAY_CODE)
Для проверки подлинности запроса используется электронная подпись, которая передается обработчику в переменной PAY_CODE. Она формируется с использованием функции md5:
PAY_CODE=md5("PAY_INTERFACE::PAY_USER::PAY_TIME::fnc::PAY_KEY")
где PAY_KEY - код автоматизации, полученный при активации интерфейса автоматической конфигурации, другие переменные описаны выше в этом пункте. Символы "::" не заменяются и служат разделителями переменных. | 
