| Правильная ссылка на эту статью: |
Интерфейс X13
Интерфейс X13. Возврат незавершенного платежа с протекцией.¶
Этот интерфейс доступен только зарегистрированным участникам. Если Вы являетесь владельцем аттестата продавца и используете merchant.web.money, то для отмены операций с протекцией совершенной на кошелек включенный в рабочем режиме Вы можете использовать данный интерфейс без дополнительной регистрации. В противном случае для регистрации перешлите по внутренней почте на "WMID 941977853154" (Техническая поддержка) краткую информацию о проекте, URL сайта, IP-адрес с которого будут отсылаться запросы, цель и способ использования интерфейса. Кипер подписывающий запросы должен иметь персональный аттестат (запросы обрабатываются до 3х раб. дней).
Интерфейс позволяет получателю перевода с протекцией (по времени или с кодом протекции) завершить еще незавершенный перевод ДО истечения срока протекции и вернуть отправленные средства отправителю. Интерфейс поддерживает работу по доверию для ВМ-идентификаторов имеющих опцию "выполнять переводы" по кошельку получателя средств (в этом случае в теге wmid может быть указан доверенный идентификатор, который отличается от идентификатора получателя средств, но может подписать и совершить данный запрос по возврату платежа с протекцией).
- URL для передачи запроса с авторизацией ключами [[WM Keeper WinPro|]] - https://w3s.web.money/asp/XMLRejectProtect.asp
- URL для передачи запроса с авторизацией ключами WM Keeper WebPro - https://w3s.wmtransfer.com/asp/XMLRejectProtectCert.asp
- метод - POST
- формат запроса:
<w3s.request>
<reqn></reqn>
<wmid></wmid>
<sign></sign>
<rejectprotect>
<wmtranid></wmtranid>
</rejectprotect>
</w3s.request>
- параметры запроса:
| название | назначение | примечание |
| reqn | номер запроса | целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса |
| wmid | WMID подписавшего запрос | используется только при авторизации с ключами WM Keeper WinPro |
| sign | подпись запроса | формируется из параметров: rejectprotect/wmtranid+reqn; используется только при авторизации с ключами WM Keeper WinPro |
| rejectprotect | параметры возвращаемой транзакции | |
| rejectprotect\wmtranid | номер транзакции | в теге указывается номер транзакции (целое положительное число) по внутреннему учету WebMoney Transfer (wmtranid), при этом тип этой транзакции должен быть с протекцией (по коду или по времени), а состояние транзакции с протекцией - не завершена |
- формат ответа:
<w3s.response>
<reqn></reqn>
<retval></retval>
<retdesc></retdesc>
<operation id="n1" ts="n2">
<opertype></opertype>
<dateupd></dateupd>
</operation>
</w3s.response>
- параметры ответа:
| название | назначение | примечание |
| reqn | номер запроса | |
| retval | код выполнения | 0 - запрос выполнен успешно, интерфейс возвращает те же коды ошибок, что и Интерфейс X2 |
| retdesc | расшифровка кода выполнения | |
| operation | параметры совершенной операции | атрибут id - уникальный номер транзакции в системе учета WebMoney; атрибут ts - служебный номер транзакции в системе учета WebMoney |
| operation\opertype | тип перевода (платежа) | может иметь 3 значения: 0 - обычный (средства успешно переданы от отправителя к получателю), 4 - с протекцией (не завершена), 12 - с протекцией (вернулась) |
| operation\dateupd | дата и время последнего изменения состояния операции |
см. также XML-интерфейсы