Правильная ссылка на эту статью: |
Интерфейс WMC3
Интерфейс WMC3. Запрос на получение реестра реализованных платежей (WebMoney.Check)¶
Рекомендуется выполнять для контроля реализации зачисления средств на кошелек соответствующего типа в текущем периоде. Реестр может быть получен за временной интервал не более 3 месяцев.
Юридическое лицо, использующее согласно договору средства аутентификации WMID, подписывающее запрос должно иметь подписанный договор с уполномоченным представителем системы WebMoney Transfer.
- URL для передачи — https://transfer.gdcert.com/ATM/Xml/History1.ashx
- метод – POST
- формат запроса:
<w3s.request lang="" incoming=""> <wmid></wmid> <sign type=""></sign> <datestart></datestart> <dateend></dateend> <wmtranid></wmtranid> </w3s.request>
- параметры запроса:
название | назначение | примечание |
lang | язык сообщений | используется для установки языка ответа. Допустимые значения: "en" - английский язык, "ru" - русский язык. При отсутствии атрибута, lang ="en" |
incoming | тип реестра | используется для указания типа платежей включаемых в реестр. Допустимые значения: "0" - платежи в адрес пользователей Webmoney, "1" - платежи пополнения реквизита относительно договора. При отсутствии атрибута, incoming ="0" |
wmid | WMID подписавшего запрос | используется при авторизации с ключами WM Keeper WinPro или сертификатом X.509 WM Keeper WebPro |
sign | подпись запроса | формируется из параметров: wmid + datestart + dateend + wmtranid |
sign/@type | тип подписи запроса | 1 - подпись сформирована с использованием специального модуля аутентификации для ключей WM Keeper WinPro, 2 - подпись сформирована с использованием сертификата X.509 WM Keeper WebPro в кодировке base64 |
datestart | начальная дата | временной интервал по часам WebMoney Transfer и имеют формат YYYYMMDD HH:MM:SS, где YYYY – число года, MM – число месяца, DD – число дня, HH - часы, MM - минуты, SS - секунды |
dateend | конечная дата | временной интервал по часам WebMoney Transfer и имеют формат YYYYMMDD, где YYYY – число года, MM – число месяца, DD – число дня, HH - часы, MM - минуты, SS - секунды |
wmtranid - Не обязательный параметр !!! | номер транзакции в системе WebMoney Transfer | уникальный номер операции в системе WebMoney Transfer |
- формат ответа:
<w3s.response> <retval></retval> <retdesc></retdesc> <datestart></datestart> <dateend></dateend> <history cnt=""> <payment id="" merchant="" status="" test=""> <purse></purse> <phone></phone> <date></date> <point></point> <price></price> <amount></amount> <comiss></comiss> <wmtranid></wmtranid> <dateupd></dateupd> <rest></rest> </payment> </history> </w3s.response>
- параметры ответа:
название | назначение | примечание |
retval | код состояния или ошибки | 0 - запрос выполнен успешно. другие значения кодов ответа говорят о неудачном прохождении запроса. |
retdesc | текстовое описание ошибки/пусто | "текст описания ошибки. произвольная строка от 0 до 255 символов; кодировка win-1251" |
datestart | начальная дата | временной интервал по часам WebMoney Transfer и имеют формат YYYYMMDD HH:MM:SS, где YYYY – число года, MM – число месяца, DD – число дня, HH - часы, MM - минуты, SS - секунды |
dateend | конечная дата | временной интервал по часам WebMoney Transfer и имеют формат YYYYMMDD, где YYYY – число года, MM – число месяца, DD – число дня, HH - часы, MM - минуты, SS - секунды |
history/@cnt | количество платежей, полученных по запросу | количество платежей, удовлетворяющих запросу. Задается целым десятичным числом, заключенным в двойные кавычки и содержит не более 18 цифр. |
payment/@id | уникальный номер транзакции | уникальный номер транзакции в системе Клиентом, формируемый Клиентом. Задается целым десятичным числом, заключенным в двойные кавычки и содержит не более 18 цифр. уникальность «id» позволяет выполнять запрос на проведение платежа при реализации ЭЧП повторно с тем же номером транзакции и параметрами в случае не получения ответа на запрос (обрыв связи и т.д.) или неудачном прохождении запроса. При повторном запросе с этим же номером, для уже принятого платежа, будет возвращено состояние данного платежа. |
payment/@merchant | тип платежа | определяет тип платежа, "1" - в адрес Продавца. |
payment/@status | направленность платежа | check - создан WebMoney чек , "purse" - зачисление на кошелек. |
payment/@test | режим запроса | определяет режим запроса и имеет два значения, "1"- платеж проводится в тестовом режиме, "0" - платеж реальный. |
См. также
XML-интерфейсы зачисления WMZ и WME