Правильная ссылка на эту статью: |
Интерфейс X5
Интерфейс X5. Завершение операции с протекцией сделки. Ввод кода протекции.¶
Этот интерфейс доступен только зарегистрированным участникам. Интерфейс доступен участникам использующим Интерфейс X2
- URL для передачи запроса с авторизацией по ключам [[WM Keeper WinPro] - https://w3s.webmoney.ru/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-интерфейсы