Читатель
Этот интерфейс доступен только зарегистрированным клиентам. Для регистрации перешлите по внутренней почте на WMID 941977853154 (Техническая поддержка) краткую информацию о проекте, URL сайта, IP-адрес с которого будут отсылаться запросы, цель и способ использования интерфейса. Кипер подписывающий запросы должен иметь персональный аттестат (запросы обрабатываются до 3х раб. дней).
<w3s.request> <reqn></reqn> <wmid></wmid> <sign></sign> <trans> <tranid></tranid> <pursesrc></pursesrc> <pursedest></pursedest> <amount></amount> <period></period> <pcode></pcode> <desc></desc> <wminvid></wminvid> <onlyauth></onlyauth> </trans> </w3s.request>
| название | назначение | примечание |
| reqn | номер запроса | целое без знака, макс. количество цифр – 15; всегда должен быть больше номера предыдущего запроса на перевод средств!!! |
| wmid | WMID подписавшего запрос | используется только при авторизации с ключами WM Keeper Classic |
| sign | подпись запроса | формируется из параметров: reqn+tranid+pursesrc+pursedest+amount+period+pcode+desc+wminvid используется только при авторизации с ключами WM Keeper Classic |
| trans | параметры перевода | |
| trans\tranid | номер перевода | номер перевода в системе учета отправителя; любое целое число без знака, должно быть уникальным (два перевода с одним и тем же tranid невозможен) |
| trans\pursesrc | номер кошелька с которого выполняется перевод (отправитель) | |
| trans\pursedest | номер кошелька, на который выполняется перевод (получатель) | |
| trans\amount | переводимая сумма | число с плавающей точкой (разделитель – .(точка) ) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 – не верно, 10.5 – верно, 9. – не верно, 9 – верно) |
| trans\period | срок протекции сделки в днях | целое от 0 до 255 символов; 0 – без протекции |
| trans\pcode | код протекции сделки | произвольная строка от 0 до 255 символов; пробелы в начале или конце не допускаются |
| trans\desc | описание оплачиваемого товара или услуги | произвольная строка от 0 до 255 символов; пробелы в начале или конце не допускаются |
| trans\wminvid | номер счета (в системе WebMoney), по которому выполняется перевод | целое число > 0; если 0 – перевод не по счету; максимально 2 32 -1 |
| trans\onlyauth | учитывать разрешение получателя | если 0 – перевод будет выполняться без учета разрешает ли получатель перевод; 1 – перевод будет выполняться только если получатель разрешает перевод (в противном случае код возврата – 35) |
Примечание!
Значение параметра trans\amount (переводимая сумма) не может быть меньше значения, приведенного в таблице:
| тип | минимальное значение |
| WMZ | 0.01 |
| WME | 0.01 |
| WMR | 0.01 |
| WMU | 0.01 |
| WMY | 1000 |
| WMB | 2000 |
| WMG | 0.01 |
<w3s.response> <reqn></reqn> <retval></retval> <retdesc></retdesc> <operation id="n1" ts="n2"> <tranid></tranid> <pursesrc></pursesrc> <pursedest></pursedest> <amount></amount> <comiss></comiss> <opertype></opertype> <period></period> <wminvid></wminvid> <orderid></orderid> <desc></desc> <datecrt></dateupd> <dateupd></dateupd> </operation> </w3s.response>
| название | назначение | примечание |
| reqn | номер запроса | |
| retval | код выполнения запроса | 0 – запрос выполнен; остальные коды см. ниже |
| retdesc | расшифровка кода выполнения запроса | |
| operation | параметры выполненного перевода (транзакции) | атрибут id – уникальный номер транзакции в системе учета WebMoney атрибут ts – служебный номер транзакции в системе учета WebMoney |
| operation\tranid | номер перевода | номер перевода в системе учета отправителя; любое целое число без знака, должно быть уникальным (два перевода с одним и тем же tranid невозможны) |
| operation\pursesrc | номер кошелька с которого выполняется перевод (отправитель) | |
| operation\pursedest | номер кошелька, на который выполняется перевод (получатель) | |
| operation\amount | сумма платежа | число с плавающей точкой (разделитель – .(точка) ) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 – не верно, 10.5 – верно, 9. – не верно, 9 – верно) |
| operation\comiss | комиссия за выполненный платеж | число с плавающей точкой (разделитель – .(точка) ) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 – не верно, 10.5 – верно, 9. – не верно, 9 – верно) |
| operation\opertype | тип перевода (платежа) | 0 – обычный; 4 – с протекцией |
| operation\period | срок протекции сделки в днях | целое число от 0 до 255; если 0 – платеж без протекции сделки |
| operation\wminvid | номер счета (в системе WebMoney), по которому выполняется перевод | целое число > 0; если 0 – перевод не по счету |
| operation\orderid | номер счета (в системе магазина, выдавшего счет), по которому выполняется перевод | целое число > 0; если 0 – перевод не по счету |
| operation\desc | описание оплачиваемого товара или услуги | |
| operation\datecrt | дата и время выполнения операции | |
| operation\dateupd | дата и время последнего изменения состояния операции |
| код | описание |
| -100 | общая ошибка при разборе команды. неверный формат команды. |
| -110 | запросы отсылаются не с того IP адреса, который указан при регистрации данного интерфейса в Технической поддержке. |
| -1 | неверное значение поля w3s.request/reqn |
| -2 | неверное значение поля w3s.request/sign |
| -3 | неверное значение поля w3s.request/trans/tranid |
| -4 | неверное значение поля w3s.request/trans/pursesrc |
| -5 | неверное значение поля w3s.request/trans/pursedest |
| -6 | неверное значение поля w3s.request/trans/amount |
| -7 | неверное значение поля w3s.request/trans/desc |
| -8 | слишком длинное поле w3s.request/trans/pcode |
| -9 | поле w3s.request/trans/pcode не должно быть пустым если w3s.request/trans/period > 0 |
| -10 | поле w3s.request/trans/pcode должно быть пустым если w3s.request/trans/period = 0 |
| -11 | неверное значение поля w3s.request/trans/wminvid |
| -12 | идентификатор переданный в поле w3s.request/wmid не зарегистрирован |
| -14 | проверка подписи не прошла |
| -15 | неверное значение поля w3s.request/wmid |
| 102 | не выполнено условие постоянного увеличения значения параметра w3s.request/reqn |
| 103 | транзакция с таким значением поля w3s.request/trans/tranid уже выполнялась |
| 110 | нет доступа к интерфейсу |
| 111 | попытка перевода с кошелька не принадлежащего WMID, которым подписывается запрос; при этом доверие не установлено. |
| 4, 15, 19, 23 | внутренняя ошибка при создании транзакции |
| 5 | идентификатор отправителя не найден |
| 6 | корреспондент не найден |
| 7 | кошелек получателя не найден |
| 11 | кошелек отправителя не найден |
| 13 | сумма транзакции должна быть больше нуля |
| 17 | недостаточно денег в кошельке для выполнения операции |
| 21 | счет, по которому совершается оплата не найден |
| 22 | по указанному счету оплата с протекцией не возможна |
| 25 | время действия оплачиваемого счета закончилось |
| 26 | в операции должны участвовать разные кошельки |
| 29 | типы кошельков отличаются |
| 30 | кошелек не поддерживает прямой перевод |
| 35 | плательщик не авторизован корреспондентом для выполнения данной операции |
| 58 | превышен лимит средств на кошельках получателя |
Категория: XML-интерфейсы
This article in other languages: English