Wiki

Интерфейс X3

Интерфейс X3. Получение истории операций по кошельку. Проверка выполнения операции по переводу средств.

<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 не используется при поиске операций
4. Интерфейс гарантированно позволяет получить историю операций не старше чем 6 месяцев

  • формат ответа:
<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-интерфейсы