Этот интерфейс доступен только зарегистрированным клиентам. Если Вы являетесь владельцем аттестата продавца и используете merchant.webmoney.ru, то для возврата средств без комиссии с кошелька, включенного в рабочем режиме, Вы можете использовать данный интерфейс без дополнительной регистрации. В противном случае для регистрации перешлите по внутренней почте на WMID 941977853154 (Техническая поддержка) краткую информацию о проекте, URL сайта, IP-адрес с которого будут отсылаться запросы, цель и способ использования интерфейса. Кипер подписывающий запросы должен иметь персональный аттестат (запросы обрабатываются до 3х раб. дней).
Интерфейс позволяет получателю любого обычного перевода в течении 30 дней с момента его совершения произвести обратный бескомиссионный перевод на ту же сумму и с того же кошелька получателя на тот же кошелек отправителя. Интерфейс поддерживает работу по доверию для ВМ-идентификаторов имеющих опцию “выполнять переводы” по кошельку получателя средств (в этом случае в теге wmid может быть указан доверенный идентификатор, который отличается от идентификатора получателя средств, но может подписать и совершить данный запрос по бескомиссионному возврату платежа).
RU
EN
<w3s.request>
<reqn></reqn>
<wmid></wmid>
<sign></sign>
<trans>
<inwmtranid></inwmtranid>
<amount></amount>
<moneybackphone></moneybackphone>
</trans>
</w3s.request>
| название | назначение | примечание |
| reqn | номер запроса | целое без знака, макс. количество цифр – 15; всегда должен быть больше номера предыдущего запроса |
| wmid | WMID подписавшего запрос | используется только при авторизации с ключами WM Keeper Classic |
| sign | подпись запроса | формируется из параметров: reqn+trans/inwmtranid+trans/amount, используется только при авторизации с ключами WM Keeper Classic |
| trans | параметры возращаемой транзакции | |
| trans\inwmtranid | номер транзакции | в теге указывается номер транзакции (целое положительное число) по внутреннему учету WebMoney Transfer (wmtranid), которую необходимо вернуть, при этом тип этой транзакции должен быть – обычная (opertype=0) |
| trans\amount | сумма транзакции | в теге указывается сумма которую необходимо вернуть, она не может превышать исходную сумму входящей траназкции, в противном случае будет выдана ошибка. Если сумма возврата меньше исходной суммы, то интерфейс может быть вызван повторно несколько раз до тех пор, пока отправителю не будет возвращена вся сумма. Винмание !!! При не полном первом возврате не на всю исходную сумму при повторных возвратах нет защиты от дублирования! Например, если исходный платеж был на 300 ВМ, а возвращется только 50 ВМ, и при этом по каким то причинам не известен результат вызова (нет wmtransid возврата), то нельзя пробовать вернуть 50 ВМ еще раз, не убедившись что первая траназкция не прошла. Единственная проверка, которая реализована при частичном возврате – в течении получаса по одной и той же траназкции нельзя вернуть одну и ту же сумму, будет выдана ошибка , но через полчаса повторный вызов на ту же сумму (если обе суммы меньше или равны исходной траназкции) приведет к успеху. |
| trans\moneybackphone | телефон клиента | В случае, если клиент производил оплату чеком Пеймер, Вебмани картой или ВМ-нотой, либо через e-invoicing (Альфа-клик, ВТБ, системы денежных переводов, Сбербонусы СПАСИБО и т.п. при наличии в исходном платеже lmi_sdp_type) в данном поле необходимо передать номер мобильного телефона клиента, на который ему в Сервис WebMoney Check будет сделан возврат. Транзакции, выполненые через Сервис WebMoney Check (как правило, такие транзакции поступают в виде оплаты через Web Merchant Interface, о чем сигнализирует наличие параметра LMI_WMCHECK_NUMBER в “форме оповещения о платеже”), возвращаются без указания номера телефона, так как он известен заранее: номер Вебмани чека – это и есть номер телефона клиента. Транзакции, выполненные через терминалы и банки в Украине с использованием Web Merchant Interface (такую транзакцию можно отличить по наличию параметра LMI_SDP_TYPE=8 “формы оповещения о платеже”, а сама транзакция поступает со служебного кошелька U329791423310), также возвращаются без указания номера телефона клиента, т.к. он уже известен системе. Транзакции выполенные с кредитных карт и через Сбербонусы СПАСИБО (lmi_sdp_type = 4 и = 7 соответсвенно)также не нуждаются в указании телефона, так как он имеется из исходного платежа. |
<w3s.response> <reqn></reqn> <retval></retval> <retdesc></retdesc> <operation id="n1" ts="n2"> <inwmtranid></inwmtranid> <pursesrc></pursesrc> <pursedest></pursedest> <amount></amount> <comiss></comiss> <desc></desc> <datecrt></dateupd> <dateupd></dateupd> </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 | дата и время последнего изменения состояния операции |
| код | описание |
| 17 | недостаточно средств на кошельке для осуществления возврата |
| 50 | транзакция inwmtranid не найдена, возможно она была совершена несколько месяцев назад или это транзакция между кредитными кошельками |
| 51 | транзакция inwmtranid имеет тип с протекцией (возвращенная или незавершенная), вернуть ее данным интерфейсом нельзя |
| 52 | сумма транзакции inwmtranid меньше суммы переданной в теге запроса trans/amount, вернуть сумму больше исходной нельзя |
| 53 | прошло более 30 дней с момента совершения транзакции 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/tranid уже выполнялась на полную сумму возврата при первом же вызове |
| 104 | транзакция с таким значением поля w3s.request/trans/tranid и с такой же частичной суммой возврата уже выполнялась, второй раз можно вызвать частичный возврат в рамках этой исходной траназкции и на эту же сумму не ранее чем через полчаса |
Произвести возврат перевода по номеру транзакции, который был получен в тестовом режиме работы (LMI_MODE=1) сервиса Merchant НЕЛЬЗЯ!
Участники, принимающие платежи через Web Merchant Interface могут вызвать данный интерфейс вручную на странице проверки транзакции
см. также XML-интерфейсы
Категория: XML-интерфейсы
This article in other languages: English