Протокол взаимодействия с плагином Hydra полностью повторяет протокол ОСМП для взаимодействия с провайдерами.
Единственное отличие от протокола ОСМП: тег osmp_txn_id с идентификатором транзакции переименован в txn_id.
*URL для обращения*: _http\[s\]://server:port/hydra_ |
Помимо базовой конфигурации, указанной в конфигурационном файле hpd (hpd.conf), используя данную платежную систему можно проводить платежи в другие системы. Для этого необходимо явно передавать ряд определенных параметров в URL. Подробная информация представлена ниже.
Для получения уникального внутреннего номера покупки продавца (параметр orderNumber) и проверки идентификационных данных в АСР "Гидра" перед запросом платежа следует использовать специальный внутренний HTTP-запрос к hpd из скриптов на сайте оператора по URL следующего вида:
_http\[AIS:s\]://server:port/hydra?command=check&bank_code=_{*}{_}BankCode{_}{*}_&account=_{*}{_}customerNumber{_}{*}_&sum=_{*}{_}Sum{_}*, где *BankCode* --- код соответствующего банка в АСР "*Гидра*", *customerNumber*, *Sum* --- идентификационные данные и сумма платежа соответственно. Часть URL _http\[AIS:s\]://server:port_ соответствует серверу *hpd*, обслуживающему запросы на проверку идентификационных данных. |
По результатам HTTP-запроса hpd возвращает XML-документ следующего вида:
<?xml version="1.0" encoding="utf-8"?> <response> <txn_id>*TxnID*</txn_id> <result>*Result*</result> <comment>*Comment*</comment> </response> |
TxnID — уникальный внутренний номер покупки продавца (параметр orderNumber), Result, Comment — код и комментарий результата соответственно.
Коды результата (Result):
Код |
Описание |
---|---|
0 |
Проверка успешна |
1 |
Внутренняя ошибка |
4 |
Неверный формат идентификационных данных |
5 |
Идентификационные данные неверны |
300 |
Другая ошибка |