Интерфейс X23

Интерфейс X23. Отказ от оплаты счета или аннулирование выставленного счета.

Кипер, подписывающий запросы, должен иметь персональный аттестат или выше.

  • метод - POST
  • формат запроса:
<w3s.request>
       <reqn></reqn>
       <wmid></wmid>
       <sign></sign>
       <invoicerefuse>
               <wmid></wmid>
               <wminvid></wminvid>
       </invoicerefuse>
</w3s.request>
  • параметры запроса:
название назначение примечание
reqn номер запроса целое без знака (Integer), макс. количество цифр - 15; всегда должен быть больше номера запроса на выписывание счета!!! Максимальное значение данного типа данных 140737488355328
wmid WMID подписавшего запрос используется только при авторизации с ключами WM Keeper WinPro
sign подпись запроса формируется из параметров: invoicerefuse/wmid+invoicerefuse/WMInvId+reqn используется только при авторизации с ключами WM Keeper WinPro
invoicerefuse параметры аннулируемого счета
invoicerefuse\wmid WMID выписавшего счет или получателя счета
invoicerefuse\wminvid номер счета уникальный номер счета в системе учета WebMoney; соответствует атрибуту "id" параметра "invoice" ответа на запрос по интерфейсу X1 (выписывание счета)
  • формат ответа:
<w3s.response>
       <reqn></reqn>
       <retval></retval>
       <retdesc></retdesc>
       <ininvoice id="n1" ts="n2">
                   <state>3</state>
                   <dateupd></dateupd>
       </ininvoice>
</w3s.response>
  • параметры ответа:
название назначение примечание
reqn номер запроса
retval код выполнения 0 - запрос выполнен успешно (остальные значения в таблице код выполнения запроса)
retdesc расшифровка кода выполнения
ininvoice параметры аннулируемого счета атрибут id - уникальный номер счета в системе учета WebMoney; атрибут ts - служебный номер счета в системе учета WebMoney
ininvoice\state состояние счета 0 - не оплачен
1 - оплачен по протекции
2 - оплачен окончательно или без протекции
3 - отказан
ininvoice\dateupd дата и время изменения состояния счета ГГГГММДД ЧЧ:ММ:СС UTC+3
  • код выполнения запроса:
код возврата описание
-100 общая ошибка при разборе команды. неверный формат команды.
-9 неверное значение поля w3s.request/reqn
-8 неверное значение поля w3s.request/sign
-1 неверное значение поля w3s.request/invoicerefuse/wmid
-2 неверное значение поля w3s.request/invoicerefuse/wminvid
-11 идентификатор, переданный в поле w3s.request/wmid не зарегистрирован
-12 проверка подписи не прошла
102 не выполнено условие постоянного увеличения значения параметра w3s.request/reqn
110 нет прав на использования интерфейса; аттестат не удовлетворяет требованиям
111 попытка аннулирования счета выставленного не на WMID, которым подписывается запрос, при этом доверие не установлено. Или попытка аннулирования счета выписанного не WMID указанном в параметре invoicerefuse\wmid.
6 получатель счета не найден
5,7 отправитель счета не найден
21 счет не найден

см. также
Интерфейс X1 — выписывание счета от одного участника другому