Настройка кошелька для взаимодействия с hpd
Для взаимодействия с hpd в разделе "Web Merchant Interface" настроек Merchant WebMoney Transfer для кошелька, на который будет приниматься платежи, необходимо установить следующие данные:
- Secret Key — любая комбинация символов, например rEYoMJrcn75kgAt1.
- Высылать Secret Key на Result URL, если Result URL обеспечивает секретность — установить галочку.
Result URL — URL на сервере hpd, обслуживающего ПС ROBOKASSA, в виде http[s]://server:port/webmoney.
- Передавать параметры в предварительном запросе — установить галочку.
- Метод формирования контрольной подписи — MD5
- Тестовый/Рабочий режимы — рабочий.
Часть URL http[s]://server:port Result URL соответствует серверу hpd, обслуживающему WebMoney Web Merchant Interface. Secret Key необходимо сохранить в конфиге hpd.
Настройка скриптов на сайте оператора
Для передачи идентификационных данных абонента, например лицевого счета, в запросах к WebMoney Web Merchant Interface следует использовать пользовательский параметр ACCOUNT.
Опционально для проверки идентификационных данных в АСР "Гидра" перед запросом платежа можно использовать специальный внутренний HTTP-запрос к hpd из скриптов на сайте оператора по URL следующего вида:
http[s]://server:port/hydra?command=check&txn_id=LMI_PAYMENT_NO&account=ACCOUNT&sum=LMI_PAYMENT_AMOUNT, где LMI_PAYMENT_NO — идентификатор транзакции (соответствует значению параметра LMI_PAYMENT_NO в запросе к ПС WebMoney Web Merchant Interface), ACCOUNT, LMI_PAYMENT_AMOUNT — идентификационные данные и сумма платежа соответственно. Часть URL http[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 — идентификатор транзакции, переданной в запросе, Result, Comment — код и комментарий результата соответственно.
Коды результата (Result):
Код |
Описание |
---|---|
0 |
Проверка успешна |
1 |
Внутренняя ошибка |
4 |
Неверный формат идентификационных данных |
5 |
Идентификационные данные неверны |
300 |
Другая ошибка |
В случае, если предварительную проверку идентификационных данных в АСР "Гидра" не производить, платеж по неверным данным все равно остановится при предварительном запросе на платеж.
Особенности взаимодействия
К сожалению, при оповещении о платеже WebMoney Web Merchant Interface не отслеживает результат запроса в hpd. Поэтому, в случае возникновения ошибки при приеме платежа, платеж нужно будет проводить заново вручную.
Подробно механизм взаимодействия с WebMoney Web Merchant Interface описан в полном руководстве на сайте Merchant WebMoney Transfer.