Правильная ссылка на эту статью: |
Интерфейс X3
Интерфейс X3. Получение истории операций по кошельку. Проверка выполнения операции по переводу средств.¶
- URL для передачи запроса с авторизацией по ключам WM Keeper WinPro (Classic) - https://w3s.webmoney.ru/asp/XMLOperations.asp (для P-кошельков - https://w3s.webmoney.ru/asp/XMLOperationsP.asp)
- URL для передачи запроса с авторизацией по ключам WM Keeper WebPro (Light) - https://w3s.wmtransfer.com/asp/XMLOperationsCert.asp (для P-кошельков - https://w3s.wmtransfer.com/asp/XMLOperationsPCert.asp)
(при возникновении проблем с сертификатом сервера, можно обращаться по альтернативному URL https://w10s.webmoney.ru) - метод - 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-интерфейсы