| Правильная ссылка на эту статью: |
Интерфейс X5
Интерфейс X5. Завершение операции с протекцией сделки. Ввод кода протекции.¶
Этот интерфейс доступен только зарегистрированным участникам. Интерфейс доступен участникам использующим Интерфейс X2
- URL для передачи запроса с авторизацией по ключам [[WM Keeper WinPro] - https://w3s.web.money/asp/XMLFinishProtect.asp
- URL для передачи запроса с авторизацией по ключам WM Keeper WebPro - https://w3s.wmtransfer.com/asp/XMLFinishProtectCert.asp
(при возникновении проблем с сертификатом сервера, можно обращаться по альтернативному URL https://w10s.webmoney.ru) - метод - POST
- формат запроса:
<w3s.request>
<reqn></reqn>
<wmid></wmid>
<sign></sign>
<finishprotect>
<wmtranid></wmtranid>
<pcode></pcode>
</finishprotect>
</w3s.request>
- параметры запроса:
| название | назначение | примечание |
| reqn | номер запроса | целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса на перевод средств!!! |
| wmid | WMID подписавшего запрос | используется только при авторизации с ключами WM Keeper WinPro |
| sign | подпись запроса формируется из параметров: wmtranid+pcode+reqn | используется только при авторизации с ключами WM Keeper WinPro |
| finishprotect | параметры завершаемой операции | |
| finishprotect\wmtranid | уникальный номер платежа в системе учета WebMoney | целое число без знака |
| finishprotect\pcode | код протекции сделки | произвольная строка от 1 до 255 символов; пробелы в начале или конце не допускаются Для зачисления перевода, который был сделан через Web Merchant Interface с возможностью холдирования, параметр должен быть пустым |
- формат ответа:
<w3s.response>
<reqn></reqn>
<retval></retval>
<retdesc></retdesc>
<operation id="n1" ts="n2">
<opertype></opertype>
<dateupd></dateupd>
</operation>
</w3s.response>
- параметры ответа:
| название | назначение | примечание |
| reqn | номер запроса | |
| retval | код выполнения запроса | 0 - запрос выполнен 20 - код протекции неверен, но кол-во попыток ввода кода (8) не исчерпано |
| retdesc | расшифровка кода выполнения запроса | |
| operation | параметры выполненного перевода (платежа) | атрибут id - уникальный номер платежа в системе учета WebMoney атрибут ts - служебный номер платежа в системе учета WebMoney |
| operation\opertype | тип перевода (платежа) | 0 - обычный 12 - платеж с протекцией возвращен, так как срок протекции закончился или превышено кол-во попыток ввода кода протекции (8) |
| operation\dateupd | дата и время последнего изменения состояния операции | формат ГГГГММДД ЧЧ:ММ:СС |
см. также XML-интерфейсы