Протокол взаимодействия с плагином Hydra полностью повторяет протокол ОСМП для взаимодействия с провайдерами.
Единственное отличие от протокола ОСМП: тег osmp_txn_id с идентификатором транзакции переименован в txn_id.
*URL для обращения*: _http\[s\: http[s]://server:port/hydra Wiki Markup
Дополнительные возможности
В дополнение к базовым возможностям протокола ОСМП платежная система Hydra умеет:
- Проводить платежи от имени других платежных систем.
- Формировать уникальный идентификатор транзакции для платежных систем, которым это необходимо (например, Яндекс.Деньги, WebMoney, ROBOKASSA и т.д.).
Проведение платежей от имени другой платежной системы
Для того, чтобы проводить платежи от имени других платежных систем, необходимо передавать в URL несколько дополнительных параметров - bank_code, to_account.
URL будет иметь следующий вид: http[s]://server:port/hydra?command=pay&txn_
...
id=<уникальный идентификатор транзакции>&txn_date=<дата в формате %Y%m%d%H%m%S>&bank_code=<код банка ПС>&account=<код ЛС абонента>&to_account=<код счета ПС у юр. лица оператора>&sum=<сумма>
Формирование уникального идентификатора транзакции
Для получения уникального внутреннего номера покупки продавца (параметр orderNumber) и проверки идентификационных данных в АСР "Гидра" перед запросом платежа следует использовать специальный внутренний HTTP-запрос к hpd (ПС Hydra) из скриптов на сайте оператора по URL следующего вида:
_http\[AIS:s\]://server:port/hydra?command=check&bank_code=_{*}{_}BankCode{_}{*}_&account=_{*}{_}customerNumber{_}{*}_&sum=_{*}{_}Sum{_}*, где *BankCode* --- код соответствующего банка в АСР "*Гидра*", *customerNumber*, *Sum* --- идентификационные данные и сумма платежа соответственно. Часть URL _http\[AIS:s\Sum&comment=Comment, где BankCode — код соответствующего банка в АСР "Гидра", customerNumber, Sum — идентификационные данные и сумма платежа соответственно, Comment - комментарий к платежу. Часть URL http[s]://server:port_ соответствует серверу *hpd*, обслуживающему запросы на проверку идентификационных данных. Wiki Markup
По результатам HTTP-запроса hpd возвращает XML-документ следующего вида:
Code Block | ||||
---|---|---|---|---|
| ||||
<?xml version="1.0" encoding="utf-8"?>
<response>
<txn_id>*TxnID*</txn_id>
<result>*Result*</result>
<comment>*Comment*</comment>
</response>
|
...