| Правильная ссылка на эту статью: |
Интерфейс X3
Интерфейс X3. Получение истории операций по кошельку. Проверка выполнения операции по переводу средств.¶
- URL для передачи запроса с авторизацией по ключам WM Keeper WinPro (Classic) - https://w3s.webmoney.ru/asp/XMLOperations.asp
- URL для передачи запроса с авторизацией по ключам WM Keeper WebPro (Light) - https://w3s.wmtransfer.com/asp/XMLOperationsCert.asp
- метод - POST
- формат запроса:
<w3s.request>
<reqn></reqn>
<wmid></wmid>
<sign></sign>
<getoperations>
<purse></purse>
<wmtranid></wmtranid>
<tranid></tranid>
<wminvid></wminvid>
<orderid></orderid>
<datestart></datestart>
<datefinish></datefinish>
</getoperations>
</w3s.request>
- параметры запроса:
| название | назначение | примечание |
| reqn | номер запроса | целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса!!! |
| wmid | WMID подписавшего запрос | используется только при авторизации с ключами WM Keeper WinPro (Classic) |
| sign | подпись запроса. Формируется из параметров: purse+reqn | используется только при авторизации с ключами WM Keeper WinPro (Classic) |
| getoperations | параметры запрашиваемой операции, по которым ведется поиск | обязательные параметры purse, datestart, datefinish, остальные можно не задавать или указывать 0 |
| getoperations\purse | номер кошелька для которого запрашивается операция | |
| getoperations\wmtranid | номер операции (в системе WebMoney) | целое число > 0 |
| getoperations\tranid | номер перевода | номер перевода в системе учета отправителя; любое целое число без знака (см. trans\tranid в интерфейсе X2) |
| getoperations\wminvid | номер счета (в системе WebMoney) по которому выполнялась операция | целое число > 0 |
| getoperations\orderid | номер счета | номер счета в системе учета магазина; любое целое число без знака (см. trans\tranid в интерфейсе X2) |
| getoperations\datestart | минимальное время и дата выполнения операции | ГГГГММДД ЧЧ:ММ:СС UTC+3 |
| getoperations\datefinish | максимальное время и дата выполнения операции | ГГГГММДД ЧЧ:ММ:СС UTC+3 |
Внимание!
1. Если один из параметров wmtranid, tranid или wminvid указан (больше нуля), то datestart и datefinish не используются при поиске операций.
2. Если указан wminvid, то параметр wmtranid не используется при поиске операций
3. Если указан tranid, то параметр wmtranid не используется при поиске операций
- формат ответа:
<w3s.response>
<reqn></reqn>
<retval></retval>
<retdesc></retdesc>
<operations cnt="n">
<operation id="n1" ts="n2">
<pursesrc></pursesrc>
<pursedest></pursedest>
<amount></amount>
<comiss></comiss>
<opertype></opertype>
<wminvid></wminvid>
<orderid></orderid>
<tranid></tranid>
<period></period>
<desc></desc>
<datecrt></datecrt>
<dateupd></dateupd>
<corrwm></corrwm>
<rest></rest>
<timelock/>
</operation>
<operation>...</operation>
</operations>
</w3s.response>
- параметры ответа:
| название | назначение | примечание |
| reqn | номер запроса | |
| retval | код выполнения запроса | 0 - запрос выполнен |
| retdesc | расшифровка кода выполнения запроса | |
| operations | список платежей, полученных по запросу | атрибут cnt - кол-во платежей, удовлетворяющих запросу |
| operations\operation | параметры платежа | атрибут id - уникальный номер платежа в системе учета WebMoney атрибут ts - служебный номер платежа в системе учета WebMoney |
| operation\pursesrc | номер кошелька с которого выполняется перевод (отправитель) | |
| operation\pursedest | номер кошелька, на который выполняется перевод (получатель) | |
| operation\amount | сумма платежа | |
| operation\comiss | комиссия за выполненный платеж | |
| operation\opertype | тип перевода (платежа) | -0 - обычный (или с протекцией, завершенный успешно), -4 - с протекцией (не завершена), -12 - с протекцией (вернулась). |
| operation\wminvid | номер счета (в системе WebMoney), по которому выполняется перевод | целое число > 0; если 0 - перевод не по счету |
| operation\orderid | номер счета (в системе магазина, выдавшего счет), по которому выполняется перевод | целое число > 0; если 0 - перевод не по счету |
| operation\tranid | номер перевода | номер перевода в системе учета отправителя; любое целое число без знака, должно быть уникальным (два перевода с одним и тем же tranid невозможны) |
| operation\period | срок протекции сделки в днях | целое число от 0 до 255; если 0 - операция без протекции сделки |
| operation\desc | описание оплачиваемого товара или услуги | |
| operation\datecrt | дата и время выполнения операции | UTC+3 |
| operation\dateupd | дата и время последнего изменения состояния операции | UTC+3 |
| operation\corrwm | WMID корреспондента | |
| operation\rest | остаток после выполнения операции для кошелька getoperations\purse | в операциях с протекцией для отправителя выводится остаток на момент начала операции, для получателя - на момент завершения; если операция еще не завершена - выводится остаток на момент начала |
| operation\timelock | незавершенная операция с протекцией по времени | тег присутствует, только если операция еще не завершена |
- код выполнения запроса:
| код | описание |
| -100 | общая ошибка при разборе команды. неверный формат команды. |
| -110 | запросы отсылаются не с того IP адреса, который указан при регистрации данного интерфейса в Технической поддержке. |
| -1 | неверное значение поля w3s.request/wmid |
| -2 | неверное значение поля w3s.request/getoperations/purse |
| -3 | неверное значение поля w3s.request/sign |
| -4 | неверное значение поля w3s.request/reqn |
| -5 | проверка подписи не прошла |
| -7 | неверное значение поля w3s.request/getoperations/datestart |
| -8 | неверное значение поля w3s.request/getoperations/datefinish |
| -9 | WMID указанный в поле w3s.request/wmid не найден |
| 102 | не выполнено условие постоянного увеличения значения параметра w3s.request/reqn |
| 1004 | слишком большой диапазон выборки |
см. также XML-интерфейсы