| Правильная ссылка на эту статью: |
Интерфейс X6
Интерфейс X6. Отправка сообщения произвольному WM-идентификатору по внутренней почте.¶
Для данного интерфейса существует аналог, JSON интерфейс с JWT авторизацией не требующий специального модуля аутентификации для ключей WM Keeper WinPro или сертификатов x.509 .
Этот интерфейс доступен только зарегистрированным участникам. Для подключения зайдите на страницу настроек сервиса Web Merchant Interface включение производится в таблице "Дополнительные параметры". Кипер подписывающий запросы должен иметь персональный аттестат.
- URL для передачи запроса с авторизацией по ключам WM Keeper WinPro - https://w3s.web.money/asp/XMLSendMsg.asp
(при возникновении проблем с сертификатом сервера, можно обращаться по альтернативному URL https://w10s.webmoney.ru) - URL для передачи запроса с авторизацией по ключам WM Keeper WebPro - https://w3s.wmtransfer.com/asp/XMLSendMsgCert.asp
(при возникновении проблем с сертификатом сервера, можно обращаться по альтернативному URL https://w10s.wmtransfer.com) - метод - POST
- формат запроса:
<w3s.request>
<reqn></reqn>
<wmid></wmid>
<sign></sign>
<message>
<receiverwmid></receiverwmid>
<msgtext></msgtext>
<onlyauth></onlyauth>
</message>
</w3s.request>
- параметры запроса:
| название | назначение | примечание |
| reqn | номер запроса | целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса!!! |
| wmid | WMID подписавшего запрос | используется только при авторизации с ключами WM Keeper WinPro |
| sign | подпись запроса - формируется из параметров: receiverwmid+reqn+msgtext | используется только при авторизации с ключами WM Keeper WinPro |
| message | параметры передаваемого сообщения | |
| message\receiverwmid | WM-идентификатор получателя сообщения | 12 цифр |
| message\msgtext | текст сообщения | произвольная строка от 1 до 1024 символов; пробелы в начале или конце не допускаются; для перевода строки используйте '\n' (\x10, chr(10)) |
| message\onlyauth | учитывать разрешение получателя | если 0 - отправка сообщения будет выполняться без учета разрешает ли получатель отправлять ему сообщения; 1 - отправка сообщения будет выполняться, только если получатель разрешает отправлять ему сообщения (в противном случае код возврата - 35). Получатель может запретить отправлять себе сообщения в двух случаях. В первом, если отправитель является корреспондентом получателя сообщения и получатель явно в свойствах корреспондента (раздел ограничения) запретил ему отправлять в свой адрес сообщения и во-втором, если отправитель не является корреспондентом и получатель запретил всем не авторизованным (не являющимся его корреспондентами) отправлять ему сообщения. |
В случае, если в тексте сообщения или теме сообщения содержатся теги, содержимое соответствующих элементов запроса необходимо заключать в секцию CDATA: <![CDATA[ваш_текст]]>.
- формат ответа:
<w3s.response>
<reqn></reqn>
<retval></retval>
<retdesc></retdesc>
<message id="">
<receiverwmid></receiverwmid>
<msgtext></msgtext>
<datecrt>ГГГГММДД ЧЧ:ММ:СС</datecrt>
</message>
</w3s.response>
- параметры ответа:
| название | назначение | примечание |
| reqn | номер запроса | |
| retval | код выполнения запроса | 0 - запрос выполнен |
| retdesc | расшифровка кода выполнения запроса | |
| message | параметры переданного сообщения | атрибут id - уникальный номер сообщения в системе учета WebMoney |
| message\receiverwmid | WM-идентификатор получателя сообщения | 12 цифр |
| message\msgtext | текст сообщения | |
| message\datecrt | дата и время передачи сообщения | формат ГГГГММДД ЧЧ:ММ:СС |
- специфичные для интерфейса ошибки (retval):
| код | описание |
| -2 | Неверное значение поля message\receiverwmid |
| -4 | Неверное значение поля w3s.request\wmid |
| -12 | Подпись не верна |
| 6,7 | корреспондент не найден |
| 35 | получатель не принимает сообщения от не авторизованных корреспондентов |
| 102 | Не выполнено условие постоянного увеличения значения параметра w3s.request/reqn |
| 110 | нет доступа к интерфейсу |
см. также XML-интерфейсы