WebMoney

Wiki

Интерфейс WMC3

Интерфейс WMC3. Запрос на получение реестра реализованных платежей (WebMoney.Check)

Рекомендуется выполнять для контроля реализации зачисления средств на кошелек соответствующего типа в текущем периоде. Реестр может быть получен за временной интервал не более 3 месяцев.

Юридическое лицо, использующее согласно договору средства аутентификации WMID, подписывающее запрос должно иметь подписанный договор с уполномоченным представителем системы WebMoney Transfer.

<w3s.request lang="">
 <wmid></wmid>
 <sign type=""></sign>
 <datestart></datestart>
 <dateend></dateend>
 <wmtranid></wmtranid>
</w3s.request>
  • параметры запроса:
название назначение примечание
lang язык сообщений используется для установки языка ответа. Допустимые значения: "en" - английский язык, "ru" - русский язык. При отсутствии атрибута, lang ="en"
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 начальная дата временной интервал по часам WMT и имеют формат YYYYMMDD HH:MM:SS, где YYYY – число года, MM – число месяца, DD – число дня, HH - часы, MM - минуты, SS - секунды
dateend конечная дата временной интервал по часам WMT и имеют формат YYYYMMDD, где YYYY – число года, MM – число месяца, DD – число дня, HH - часы, MM - минуты, SS - секунды
wmtranid - Не обязательный параметр !!! номер транзакции в системе WMT уникальный номер операции в системе WMT
  • формат ответа:
<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 начальная дата временной интервал по часам WMT и имеют формат YYYYMMDD HH:MM:SS, где YYYY – число года, MM – число месяца, DD – число дня, HH - часы, MM - минуты, SS - секунды
dateend конечная дата временной интервал по часам WMT и имеют формат 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