WebMoney

Wiki

Интерфейс X6

Интерфейс X6. Отправка сообщения произвольному WM-идентификатору по внутренней почте.

Этот интерфейс доступен только зарегистрированным участникам. Для подключения зайдите на страницу настроек сервиса Web Merchant Interface включение производится в таблице "Дополнительные параметры". Кипер подписывающий запросы должен иметь персональный аттестат.

<w3s.request>
    <reqn></reqn>
    <wmid></wmid>
    <sign></sign>
    <message>
        <receiverwmid></receiverwmid>
        <msgsubj></msgsubj>
        <msgtext></msgtext>
        <onlyauth></onlyauth>
    </message>
</w3s.request>
  • параметры запроса:
название назначение примечание
reqn номер запроса целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса!!!
wmid WMID подписавшего запрос используется только при авторизации с ключами WM Keeper WinPro (Classic)
sign подпись запроса - формируется из параметров: receiverwmid+reqn+msgtext+msgsubj используется только при авторизации с ключами WM Keeper WinPro (Classic)
message параметры передаваемого сообщения
message\receiverwmid WM-идентификатор получателя сообщения 12 цифр
message\msgsubj тема сообщения произвольная строка от 1 до 255 символов; пробелы в начале или конце и переводы строк не допускаются
message\msgtext текст сообщения произвольная строка от 1 до 1024 символов; пробелы в начале или конце не допускаются; для перевода строки используйте '\n' (\x10, chr(10))
message\onlyauth учитывать разрешение получателя если 0 - отправка сообщения будет выполняться без учета разрешает ли получатель отправлять ему сообщения; 1 - отправка сообщения будет выполняться, только если получатель разрешает отправлять ему сообщения (в противном случае код возврата - 35). Получатель может запретить отправлять себе сообщения в двух случаях. В первом, если отправитель является корреспондентом получателя сообщения и получатель явно в свойствах корреспондента (раздел ограничения) запретил ему отправлять в свой адрес сообщения и во-втором, если отправитель не является корреспондентом и получатель запретил всем неавторизованным (не являющимся его корреспондентами) отправлять ему сообщения.

В случае, если в тексте сообщения или теме сообщения содержатся теги, содержимое соответствующих элементов запроса необходимо заключать в секцию CDATA: &lt;![CDATA[ваш_текст]]>.

  • формат ответа:
<w3s.response>
    <reqn></reqn>
    <retval></retval>
    <retdesc></retdesc>
    <message id="">
        <receiverwmid></receiverwmid>
        <msgsubj></msgsubj>
        <msgtext></msgtext>
        <datecrt>ГГГГММДД ЧЧ:ММ:СС</datecrt>
    </message>
</w3s.response>
  • параметры ответа:
название назначение примечание
reqn номер запроса  
retval код выполнения запроса 0 - запрос выполнен
retdesc расшифровка кода выполнения запроса  
message параметры переданного сообщения атрибут id - уникальный номер сообщения в системе учета WebMoney
message\receiverwmid WM-идентификатор получателя сообщения 12 цифр
message\msgsubj тема сообщения  
message\msgtext текст сообщения  
message\datecrt дата и время передачи сообщения формат ГГГГММДД ЧЧ:ММ:СС
  • специфичные для интерфейса ошибки (retval):
код описание
-2 Неверное значение поля message\receiverwmid
-12 Подпись не верна
6 корреспондент не найден
35 получатель не принимает сообщения от неавторизованных корреспондентов
102 Не выполнено условие постоянного увеличения значения параметра w3s.request/reqn

см. также XML-интерфейсы