Интерфейс автоматической конфигурации позволяет организовать моментальную настройку программой установки скрипта, приобретенного пользователем, интеграции пользовательского аккаунта с функциями данного скрипта. Этот интерфейс позволяет добавлять сайты в сервис обработки платежей Cap.GoldDengi Merchant, а также автоматические API-интерфейсы Например, программа установки скрипта казино, работающего с кредитами и деньгами Cap.GoldDengi, использующая данный интерфейс, может добавить пользовательский сайт в систему обработки платежей Cap.GoldDengi Merchant со всеми необходимыми настройками (для включения возможности приема платежей), зарегистрировать новый API-интерфейс для выплаты выигрышей, сохранить все нужные данные в БД, затем выключить интерфейс автоматической конфигурации в целях безопасности пользовательского аккаунта, а все, что нужно будет сделать пользователю - ввести свой логин и временный код автоматизации (выданный нашим сайтом) в программе установки (причем эти данные не будут сохранены, что опять же повышает безопасность, да и код автоматизации все время меняется).
- Функция 1. Добавление нового сайта для приема платежей
Данная функция позволяет добавить новый сайт в систему обработки платежей Cap.GoldDengi Merchant. Назначение полей описано кратно, более подробное описание вы найдете в руководстве по сервису обработки платежей.
Форма запроса должна иметь следующие параметры:
Action: http://caps.golddengi.com/api
Method: POST
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
PAY_INTERFACE | Да | Должен принимать значение 4.
| PAY_USER | Да | Логин продавца в системе Cap.GoldDengi
| 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 - идентификатор зарегистрированного сайта в системе Cap.GoldDengi 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://caps.golddengi.com/api
Method: POST
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
PAY_INTERFACE | Да | Должен принимать значение 4.
| PAY_USER | Да | Логин продавца в системе Cap.GoldDengi
| PAY_TIME | Да | Время совершения операции в формате UNIX_TIMESTAMP. Может отклоняться от времени сервера не более чем на 10 минут (время на сервере московское).
| PAY_CODE | Да | Контрольная подпись запроса (формирование описано ниже)
|
fnc | Да | Должен принимать значение 2
| name | Да | Название интерфейса
|
ip | Нет | Разрешенные IP-адреса
|
op | Да | Список разрешенных операций. Формат списка: каждая операция может принимать значение 0 (запрещено) или 1 (разрешено). Последовательность операций: перевод средств, перевод кредитов, проверка баланса. Например, 001 - разрешает проверку баланса, 110 - разрешает перевод денег и кредитов и запрещает проверку баланса. Обязательно должны быть переданы все три управляющих числа от 000 до 111.
|
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://caps.golddengi.com/api
Method: POST
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
PAY_INTERFACE | Да | Должен принимать значение 4.
| PAY_USER | | ДаЛогин продавца в системе Cap.GoldDengi
| 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 - код автоматизации, полученный при активации интерфейса автоматической конфигурации, другие переменные описаны выше в этом пункте. Символы "::" не заменяются и служат разделителями переменных. |