Правильная ссылка на эту статью: |
Интерфейс X13
Интерфейс X13. Возврат незавершенного платежа с протекцией.¶
Этот интерфейс доступен только зарегистрированным участникам. Если Вы являетесь владельцем аттестата продавца и используете merchant.webmoney.ru, то для отмены операций с протекцией совершенной на кошелек включенный в рабочем режиме Вы можете использовать данный интерфейс без дополнительной регистрации. В противном случае для регистрации перешлите по внутренней почте на "WMID 941977853154" (Техническая поддержка) краткую информацию о проекте, URL сайта, IP-адрес с которого будут отсылаться запросы, цель и способ использования интерфейса. Кипер подписывающий запросы должен иметь персональный аттестат (запросы обрабатываются до 3х раб. дней).
Интерфейс позволяет получателю перевода с протекцией (по времени или с кодом протекции) завершить еще незавершенный перевод ДО истечения срока протекции и вернуть отправленные средства отправителю. Интерфейс поддерживает работу по доверию для ВМ-идентификаторов имеющих опцию "выполнять переводы" по кошельку получателя средств (в этом случае в теге wmid может быть указан доверенный идентификатор, который отличается от идентификатора получателя средств, но может подписать и совершить данный запрос по возврату платежа с протекцией).
- URL для передачи запроса с авторизацией ключами [[WM Keeper WinPro|]] - https://w3s.webmoney.ru/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-интерфейсы