WebMoney

Wiki

Интерфейс X14

Бескомиссионный возврат средств отправителю (покупателю).

Этот интерфейс доступен только зарегистрированным участникам. Если Вы используете merchant.webmoney.ru, то для возврата средств без комиссии с кошелька, включенного в рабочем режиме, Вы можете использовать данный интерфейс без дополнительной регистрации. В противном случае для регистрации перешлите по внутренней почте на "WMID 941977853154" (Техническая поддержка) краткую информацию о проекте, URL сайта, IP-адрес с которого будут отсылаться запросы, цель и способ использования интерфейса. Кипер подписывающий запросы должен иметь персональный аттестат (запросы обрабатываются до 3х раб. дней).

Интерфейс позволяет получателю любого обычного перевода в течении 30 дней с момента его совершения произвести обратный бескомиссионный перевод на ту же сумму и с того же кошелька получателя на тот же кошелек отправителя. Интерфейс поддерживает работу по доверию для ВМ-идентификаторов имеющих опцию "выполнять переводы" по кошельку получателя средств (в этом случае в теге wmid может быть указан доверенный идентификатор, который отличается от идентификатора получателя средств, но может подписать и совершить данный запрос по бескомиссионному возврату платежа).

<w3s.request>
    <reqn></reqn>
    <wmid></wmid>
    <sign></sign>
        <trans>
            <inwmtranid></inwmtranid>
            <amount></amount>
                        <moneybackphone></moneybackphone>
        </trans>
<wmb_denomination>1</wmb_denomination>
</w3s.request>
  • параметры запроса:
название назначение примечание
reqn номер запроса целое без знака, макс. количество цифр - 15; всегда должен быть больше номера предыдущего запроса
wmid WMID подписавшего запрос используется только при авторизации с ключами WM Keeper WinPro (Classic)
sign подпись запроса формируется из параметров: reqn+trans/inwmtranid+trans/amount, используется только при авторизации с ключами WM Keeper WinPro (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 соответственно) также не нуждаются в указании телефона, так как он имеется из исходного платежа.
trans\capitallerpursesrc кошелек капиталлера если возврат производится с ВМИД принадлежащего аттестату капиталлера, то в данном теге необходимо передать номер расходного кошелька , принадлежащего этому капиталлеру, с которого будет осуществлен возврат. Если этого не сделать, то вызов интерфейса завершится ошибкой, так как по умолчанию с доходного кошелька, на который была сделана возвращаемая транзакция, произвести возврат нельзя.
wmb_denomination признак деноминации обязательный! 1 - перевод будет выполняться только если отправитель передает данный параметр
  • формат ответа:
<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 дата и время последнего изменения состояния операции
  • специфичные для интерфейса ошибки (retval):
код описание
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-интерфейсы