Автоматические интерфейсы Cap.GoldDengi.Com Merchant позволяют организовать моментальный перевод кредитов Cap.GoldDengi.Com и средств на внутренние счета других пользователей, полностью освобождая этот процесс от участия человека. Это дает возможность содать множество сайтов различных направлений, работающих с системой - игровые порталы, биржи кредитов Cap.GoldDengi.Com, магазины с участием множества продавцов и многое другое!
- Назначение автоматических интерфейсов
Автоматические API-интерфейсы предназначены для связи вашего сайта с нашим сервисом и организации автоматического выполнения некоторых действий, связанных с нашим сервисом. В данный момент поддерживаются три интерфейса: перевод кредитов, перевод денег, проверка баланса. В сочетании с сервисом обработки платежей, этого вполне достаточно для организации таких сервисов, как автоматическая биржа кредитов, аукцион на кредиты и деньги системы, любые виды игровых порталов, продажа товаров за деньги и кредиты пользователей и т.д.
- Описание настройки интерфейсов
Настройка параметров автоматических интерфейсов выполняется на странице настройка для каждого интерфейса отдельно. Форму настройки можно получить, нажав  на странице управления API-интерфейсами или при добавлении нового интерфейса.
Форма настройки содержит следующие параметры:
Параметр |
Обязательный |
Описание |
| Название интерфейса | Да | Введите любое название для интерфейса. Это название служит только подсказкой для вас о назначении интерфейса и больше никак не используется.
|
| Разрешенные IP-адреса | Нет | Список IP-адресов, с которых разрешено использование данного интерфейса. IP-адреса разделяются запятыми. Например: 1.1.1.1,2.2.2.2 Если значение не задано, разрешено использование интерфейса с любого IP-адреса.
|
| Разрешенные операции | Да | Отметьте галочками операции, которые может выполнять этот APi-интерфейс. Должна быть отмечена хотя бы одна операция.
|
| Секретный код | Да | Код, который используется при формировании контрольной подписи запроса(см ниже)
|
| Активность | Нет | Отметьте галочкой, чтобы включить интерфейс. Если не отмечено, интерфейс не может использоваться.
|
- Виды автоматических интерфейсов
В настоящий момент поддерживает три автоматических интерфейса: перевод кредитов, перевод средств и проверка баланса. После того, как вы включили автоматические интерфейсы, вам следует написать программу, которая будет этот интерфейс использовать. Вам следует разместить сайт на хостинге, который поддерживает выполнение пользовательских скриптов. Мы рекомендуем использовать хостинг JetHosting.ru - поддержка скриптов включена уже на минимальном тарифном плане!
- Интерфейс 1. Перевод кредитов.
- Интерфейс 2. Перевод средств.
Для использования интерфейса вам необходимо создать запрос по адресу обработчика и передать параметры операции. Пример PHP-скрипта вы можете получить в списке интерфейсов.
Action: http://Caps.GoldDengi.Com/api
Method: POST
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
| PAY_INTERFACE | Да | Интерфейс, который используется для проведения платежа. Может принимать два значения- 1 - перевод кредитов
- 2 - перевод средств
| | PAY_API | Да | ID API-интерфейса, отображается в списке интерфейсов в первой колонке.
| | PAY_TO | Да | Логин пользователя Cap.GoldDengi.Com, на счет которого производится перевод.
| | PAY_SUMM | Да | Сумма перевода
| | PAY_TIME | Да | Время перевода в формате UNIX_TIMESTAMP. Может отклоняться от времени сервера не более чем на 10 минут (время на сервере московское).
| | PAY_CODE | Да | Электронная подпись запроса (см. ниже)
|
После обработки запроса сервер вернет ответ:
Вариант ответа |
Описание |
| 0 | Операция прошла успешно
|
| 1 | Интерфейс PAY_API не активен или не существует
|
| 2 | Код PAY_CODE неверен
|
| 3 | Время PAY_TIME не соответствует предъявляемым требованиям
|
| 4 | Получатель перевода не существует
|
| 5 | Переменная PAY_INTERFACE задана неверно или отсутствует
|
| 6 | Вызывающий IP-адрес не попадает в список разрешенных
|
| 7 | Слишком маленькая сумма перевода
|
| 8 | Недостаточно средств для совершения перевода
|
| 9 | С момента изменения персональных данных не прошло 48 часов
|
| 10 | Только для перевода кредитов: операция заблокирована, пользователь не посмотрел 300 сайтов или 2000 баннеров
|
| Любое другое | Внутренняя ошибка сервера
|
Электронная подпись запроса(Параметр PAY_CODE)
Для проверки подлинности запроса используется электронная подпись, которая передается обработчику в переменной PAY_CODE. Она формируется с использованием функции md5:
PAY_CODE=md5("PAY_API::PAY_TO::PAY_SUMM::PAY_TIME::PAY_INTERFACE::PAY_KEY")
где PAY_KEY - секретный код, который вводится при настройке интерфейса, другие переменные описаны выше в этом пункте. Символы "::" не заменяются и служат разделителями переменных.
- Интерфейс 3. Проверка баланса
Для использования интерфейса вам необходимо создать запрос по адресу обработчика и передать параметры операции. Пример PHP-скрипта вы можете получить в списке интерфейсов. Данный интерфейс может использоваться на чаще одного раза в пять минут!
Action: http://Caps.GoldDengi.Com/api
Method: POST
Поля, передаваемые в форме:
Параметр |
Обязательный |
Описание |
| PAY_INTERFACE | Да | Интерфейс, который используется для проверки баланса. Должен иметь значение 3
| | PAY_API | Да | ID API-интерфейса, отображается в списке интерфейсов в первой колонке.
| | PAY_BALANCE | Да | Вид счета, для которого запрашивается баланс.
| | PAY_TIME | Да | Время перевода в формате UNIX_TIMESTAMP. Может отклоняться от времени сервера не более чем на 10 минут (время на сервере московское).
| | PAY_CODE | Да | Электронная подпись запроса (см. ниже)
|
После обработки запроса сервер вернет ответ:
Вариант ответа |
Описание |
| !Balance | Операция прошла успешно, при этом Balance будет содержать сумму запрашиваемого баланса.
|
| 1 | Интерфейс PAY_API не активен или не существует
|
| 2 | Код PAY_CODE неверен
|
| 3 | Время PAY_TIME не соответствует предъявляемым требованиям
|
| 5 | Переменная PAY_INTERFACE задана неверно или отсутствует
|
| 6 | Вызывающий IP-адрес не попадает в список разрешенных
|
| 11 | Прошло менее 5 минут с момента предыдущего запуска интерфейса
|
| 12 | Переменная PAY_BALANCE задана неверно или отсутствует
|
| Любое другое | Внутренняя ошибка сервера
|
Электронная подпись запроса (параметр PAY_CODE)
Для проверки подлинности запроса используется электронная подпись, которая передается обработчику в переменной PAY_CODE. Она формируется с использованием функции md5:
PAY_CODE=md5("PAY_API::PAY_BALANCE::PAY_TIME::PAY_INTERFACE::PAY_KEY")
где PAY_KEY - секретный код, который вводится при настройке интерфейса, другие переменные описаны выше в этом пункте. Символы "::" не заменяются и служат разделителями переменных.
- Интерфейс 4. Автоматическая конфигурация аккаунта
Интерфейс предназначен для автоматического создания добавления в аккаунт новых API-интерфейсов и сайтов для приема оплаты. Целесообразно использовать в программах установки для различных скриптов казино, обменных пунктов, магазинов и т.д. Существенно упрощает процесс установки скрипта пользователем, т.к. те действия, которые обычно делаются по скриншотам и т.п., теперь интерфейс делает сам!
|
