| Правильная ссылка на эту статью: |
Интерфейс X14
Бескомиссионный возврат средств отправителю (покупателю).¶
Этот интерфейс доступен только зарегистрированным участникам. Если Вы используете merchant.webmoney.com, то для возврата средств без комиссии с кошелька, включенного в рабочем режиме, Вы можете использовать данный интерфейс без дополнительной регистрации. В противном случае для регистрации перешлите по внутренней почте на "WMID 941977853154" (Техническая поддержка) краткую информацию о проекте, URL сайта, IP-адрес с которого будут отсылаться запросы, цель и способ использования интерфейса. Кипер подписывающий запросы должен иметь персональный аттестат (запросы обрабатываются до 3х раб. дней).
Интерфейс позволяет получателю любого обычного перевода в течении 90 дней с момента его совершения произвести обратный бескомиссионный перевод на ту же сумму и с того же кошелька получателя на тот же кошелек отправителя. Интерфейс поддерживает работу по доверию для ВМ-идентификаторов имеющих опцию "выполнять переводы" по кошельку получателя средств (в этом случае в теге wmid может быть указан доверенный идентификатор, который отличается от идентификатора получателя средств, но может подписать и совершить данный запрос по бескомиссионному возврату платежа).
- URL для передачи запроса с авторизацией ключами WM Keeper WinPro - https://w3s.web.money/asp/XMLTransMoneyback.asp
- URL для передачи запроса с авторизацией ключами WM Keeper WebPro - https://w3s.wmtransfer.com/asp/XMLTransMoneybackCert.asp
- метод - POST
- формат запроса:
<w3s.request>
<reqn></reqn>
<wmid></wmid>
<sign></sign>
<trans>
<inwmtranid></inwmtranid>
<amount></amount>
<moneybackphone></moneybackphone>
</trans>
</w3s.request>
- параметры запроса:
| название | назначение | примечание |
| reqn | номер запроса | целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса |
| wmid | WMID подписавшего запрос | используется только при авторизации с ключами WM Keeper WinPro |
| sign | подпись запроса | формируется из параметров: reqn+trans/inwmtranid+trans/amount, используется только при авторизации с ключами WM Keeper WinPro |
| trans | параметры возвращаемой транзакции | |
| trans\inwmtranid | номер транзакции | в теге указывается номер транзакции (целое положительное число) по внутреннему учету WebMoney Transfer (wmtranid), которую необходимо вернуть, при этом тип этой транзакции должен быть - обычная (opertype=0) |
| trans\amount | сумма транзакции | в теге указывается сумма, которую необходимо вернуть, она не может превышать исходную сумму входящей транзакции, в противном случае будет выдана ошибка. Если сумма возврата меньше исходной суммы, то интерфейс может быть вызван повторно несколько раз до тех пор, пока отправителю не будет возвращена вся сумма. Внимание !!! При неполном первом возврате не на всю исходную сумму при повторных возвратах нет защиты от дублирования! Например, если исходный платеж был на 300 ВМ, а возвращается только 50 ВМ, и при этом по каким-то причинам не известен результат вызова (нет wmtransid возврата), то нельзя пробовать вернуть 50 ВМ еще раз, не убедившись что первая транзакция не прошла. Единственная проверка, которая реализована при частичном возврате - в течении получаса по одной и той же транзакции нельзя вернуть одну и ту же сумму, будет выдана ошибка , но через полчаса повторный вызов на ту же сумму (если обе суммы меньше или равны исходной транзакции) приведет к успеху. |
| trans\moneybackphone | телефон покупателя | В случае, если покупатель производил оплату чеком Пеймер, Вебмани картой, либо через e-invoicing (карты российского банка и т.п. при наличии в исходном платеже lmi_sdp_type) в данном поле необходимо передать номер мобильного телефона покупателя, на который ему в Сервис WebMoney Check будет сделан возврат.Транзакции выполненные с кредитных карт (lmi_sdp_type = 4) также не нуждаются в указании телефона, так как он имеется из исходного платежа, кроме случаев, когда в исходном платеже нет телефона. |
| trans\capitallerpursesrc | кошелек капиталлера | если возврат производится с ВМИД принадлежащего аттестату капиталлера, то в данном теге необходимо передать номер расходного кошелька , принадлежащего этому капиталлеру, с которого будет осуществлен возврат. Если этого не сделать, то вызов интерфейса завершится ошибкой, так как по умолчанию с доходного кошелька, на который была сделана возвращаемая транзакция, произвести возврат нельзя. |
- формат ответа:
<w3s.response>
<reqn></reqn>
<retval></retval>
<retdesc></retdesc>
<operation id="n1" ts="n2">
<tranid>0</tranid>
<inwmtranid></inwmtranid>
<pursesrc></pursesrc>
<pursedest></pursedest>
<amount></amount>
<comiss></comiss>
<opertype></opertype>
<period></period>
<wminvid></wminvid>
<orderid></orderid>
<desc></desc>
<datecrt></dateupd>
<dateupd></dateupd>
<corrwm></corrwm>
<outgosrc></outgosrc>
<incomedest></incomedest>
</operation>
</w3s.response>
- параметры ответа:
| название | назначение | примечание |
| reqn | номер запроса | |
| retval | код выполнения | 0 - запрос выполнен успешно, интерфейс возвращает те же коды ошибок, что и Интерфейс X2, за исключением специфичных для интерфейса ошибок, перечисленных ниже |
| retdesc | расшифровка кода выполнения | |
| operation | параметры совершенной операции | атрибут id - уникальный номер счета в системе учета WebMoney; атрибут ts - служебный номер счета в системе учета WebMoney |
| operation\inwmtranid | номер возвращаемой транзакции | |
| operation\pursesrc | номер кошелька | с которого произведен возврат и на который поступила транзакция inwmtranid |
| operation\pursdest | номер кошелька | на который произведен возврат и с которого была произведена транзакция inwmtranid |
| operation\amount | сумма возврата | сумма возврата |
| operation\comiss | комиссия возврата | = 0 |
| operation\desc | примечание возврата | для операций по возврату , совершенных интерфейсом всегда имеет формат "Moneyback transaction WMTranId: InWMTranID. (inwmtranid_desc)", где inwmtranid_desc = оригинальное примечание к транзакции InWMTranID. |
| operation\datecrt | дата и время выполнения операции | |
| operation\dateupd | дата и время последнего изменения состояния операции |
- специфичные для интерфейса ошибки (retval):
| код | описание |
| 17 | недостаточно средств на кошельке для осуществления возврата |
| 50 | транзакция inwmtranid не найдена, возможно она была совершена несколько месяцев назад или это транзакция между кредитными кошельками |
| 51 | транзакция inwmtranid имеет тип с протекцией (возвращенная или незавершенная), вернуть ее данным интерфейсом нельзя |
| 52 | сумма транзакции inwmtranid меньше суммы переданной в теге запроса trans/amount, вернуть сумму больше исходной нельзя |
| 53 | прошло более 90 дней с момента совершения транзакции inwmtranid |
| 54 | транзакция выполнена с кошельков сервиса PAYMER при помощи ВМ-карты , ВМ-ноты или чека Пеймер, при этом параметр moneybackphone в запросе не был указан и возврат не может быть осуществлен, необходимо получить у покупателя номер мобильного телефона и передать его в moneybackphone , чтобы покупателю был сделан возврат на этот телефон в Сервис WebMoney Check |
| 55 | транзакция выполнена через e-invoicing (параметр lmi_sdp_type в resulturl )а moneybackphone в запросе не был указан (при этом тип lmi_sdp_type платежа тако что в системе нет номера телефона покупателя) и возврат не может быть осуществлен, необходимо получить у покупателя номер мобильного телефона и передать его в moneybackphone , чтобы был сделан возврат на этот телефон в Сервис WebMoney Check |
| 56 | сумма транзакции inwmtranid меньше суммы переданной в теге запроса trans/amount и сумм , которые возвращались в рамках транзакции inwmtranid ранее |
| 103 | транзакция с таким значением поля w3s.request/trans/inwmtranid уже выполнялась на полную сумму возврата при первом же вызове |
| 104 | транзакция с таким значением поля w3s.request/trans/inwmtranid и с такой же частичной суммой возврата уже выполнялась, второй раз можно вызвать частичный возврат в рамках этой исходной транзакции и на эту же сумму не ранее чем через полчаса |
Произвести возврат перевода по номеру транзакции, который был получен в тестовом режиме работы (LMI_MODE=1) сервиса Merchant НЕЛЬЗЯ!
Участники, принимающие платежи через Web Merchant Interface могут вызвать данный интерфейс вручную на странице проверки транзакции
см. также XML-интерфейсы