Интерфейс X20

Интерфейс X20. Проведение транзакции в merchant.webmoney без ухода с сайта (ресурса, сервиса, приложения) продавца

Этот интерфейс доступен только участникам, использующим сервис merchant.webmoney.ru (merchant.wmtransfer.com). Платеж невозможен с кошельков, зарегистрированных в merchant.webmoney.ru (merchant.wmtransfer.com)

Ролик, демонстрирующий оплату через X20

Интерфейс позволяет произвести прием средств от участника WebMoney Transfer непосредственно на сайте, сервисе, приложении, консоли и т.п. (здесь и далее приложении продавца) не требуя от участника перехода на какие-либо сайты системы. При этом платеж будет проведен таким образом, как если бы участник заплатил обычным образом через merchant.webmoney.
Эффект отсутствия необходимости покидать сайт достигается тем, что участник подтверждает списание средств со своего WebMoney кошелька (или WebMoney чека) различными мобильными способами, в данный момент их три:

• Подтверждение SMS-кодом, присланным на мобильный телефон участника
• Подтверждение USSD-запросом, присланным на мобильный телефон покупателя
• Оплатой WM-счета, выписанного участнику. В данный момент оплата ВМ-счетов возможна во всех мобильных (и вообще любых) приложениях по управлению кошельками WebMoney Transfer.

В случае авторизации по СМС\USSD с покупателя взимается дополнительная фиксированная комиссия в размере 0.9 WMR, 0.04 WMZ, 0.03 WME, 0.25 WMU, в зависимости от валюты платежа.

Интерфейс работает по тому же принципу идентификации и аутентификации продавца, что и Интерфейс X18 (WMSigner или MD5 или Secret key) и доступен как обычным продавцам, использующим merchant.webmoney, так и владельцам WMID Capitaller или продавцам зарегистрированным в сервисе processing.webmoney .

На воображаемом примере работу интерфейса можно описать следующим образом. Допустим покупатель находится в приложении какой-либо игровой консоли и собирается произвести оплату какой-либо услуги (игры).
При выборе способа оплаты через Вебмани покупателю предлагается указать свой номер мобильного телефона, ВМ-идентификатор или e-mail (либо взять эту информацию из профайла участника), чтобы инициировать оплату.
Далее приложение (серверная сторона приложения продавца) передает эту информацию (вместе с другими параметрами платежа, суммой и т.п) в первом XML запросе данного интерфейса. Результатом выполнения этого запроса является поиск участника по переданным данным и отправка СМС кода, USSD запроса или выписка ВМ-счета.
После успешного выполнения этого запроса приложение продавца предлагает покупателю либо ввести подтверждающий код, присланный на СМС, либо подтвердить, что USSD запрос получен и одобрен либо ВМ-счет получен и оплачен. В этом случае приложение продавца осуществляет вызов второго XML-запроса данного интерфейса в результате выполнения которого производится оплата и в ответе на запрос продавец получает те же данные,
которые он получил бы, если бы оплата произошла обычным способом через merchant.webmoney.

Пример использования интерфейса (эмуляция вызова и тексты запросов), воспользоваться тестом смогут только пользователи сервиса merchant.webmoney или разработчики, имеющие на своем ВМИД кошельки, настроенные в merchant.webmoney в рабочем или тестовом режиме.

• URL для передачи первого, инициирующего запроса – https://merchant.webmoney.ru/conf/xml/XMLTransRequest.asp
• метод – POST
• формат запроса:

<merchant.request>
	<wmid></wmid>
	<lmi_payee_purse></lmi_payee_purse>
	<lmi_payment_no></lmi_payment_no>
	<lmi_payment_amount></lmi_payment_amount> 
	<lmi_payment_desc></lmi_payment_desc> 
	<lmi_clientnumber></lmi_clientnumber> 	
	<lmi_clientnumber_type></lmi_clientnumber_type> 	
	<lmi_sms_type></lmi_sms_type>
	<secret_key></secret_key>
	<sign></sign>
	<md5></md5>
</merchant.request>

• параметры запроса:

• формат ответа:

<?xml version="1.0"?>
<merchant.response>
	<operation  wminvoiceid="">
		<realsmstype></realsmstype>
	</operation> 
	<retval>0</retval> 
	<retdesc></retdesc>
	<userdesc></userdesc>  
</merchant.response> 

• параметры ответа:

Задача приложения продавца при успешном вызове первого запроса, получить и сохранить соответствующее платежу значение wminvoiceid.
Без этого значения не может быть вызван второй, подтверждающий оплату запрос. Если по каким-либо причинам (имеются ввиду обрывы связи, таймауты и прочие НЕявные или недокументированные ошибки) данное значение не получено или не сохранено, то необходимо вызвать первый запрос повторно (при этом не меняя его!!!), при этом все параметры должны оставаться без изменений.
Если состояние запроса не будет выяснено и не будет получен wminvoiceid, то повторный вызов с изменением какого-либо параметра, например суммы платежа, приведет к выписке нового ВМ-счета и отправке новой СМС-ки, при этом потенциально возможна ситуация, когда покупатель оплатит ОБА счета, хотя исходя из логики работы приложения продавца возможна только единственная оплата.
В случае необходимости отмены приема средств по какому-либо wminvoiceid возможен вызов подтверждающего интерфейса с параметрами отказа от приема оплаты по счету wminvoiceid, в этом случае, если оплата еще не произошла до момента вызова отказа, то она и не будет произведена и приложение продавца может выставить новый счет, не опасаясь поступления средств по предыдущему счету.

Также в любой момент приложение продавца может выяснить состояние счета wminvoiceid путем вызова интерфейса X18 либо вызова повторного, подтверждающего интерфейса XMLTransConfirm.asp

Обратите внимание, что если Ваш кошелек продавца находится в тестовом режиме (например это тестовый кошелек разработчика), то чтобы отладить работу интерфейса необходимо чтобы входящие параметры удовлетворяли следующим условиям lmi_payment_amount<2, lmi_payment_no<10 , lmi_payment_desc=X20 test payment, иными словами необходимо чтобы сумма не превышала 2 ВМ в любой валюте, номера платежей не превышали 10 , а примечание состояло строго из трех указанных слов на английском.

• URL для передачи второго, подтверждающего запроса – https://merchant.webmoney.ru/conf/xml/XMLTransConfirm.asp
• метод – POST
• формат запроса:

<merchant.request>
	<wmid></wmid>
	<lmi_payee_purse></lmi_payee_purse>
	<lmi_clientnumber_code></lmi_clientnumber_code> 	
	<lmi_wminvoiceid></lmi_wminvoiceid> 	
	<secret_key></secret_key>
	<sign></sign>
	<md5></md5>
</merchant.request>

• параметры запроса:

• формат ответа:

<?xml version="1.0"?>
<merchant.response>
	<operation  wmtransid="" wminvoiceid="">
		<amount></amount>
		<operdate></operdate>
		<purpose></purpose>
		<pursefrom></pursefrom>
		<wmidfrom></wmidfrom>
	</operation> 
	<retval>0</retval> 
	<retdesc></retdesc> 
	<userdesc></userdesc> 
</merchant.response> 

• параметры ответа:

Напоминаем, что для возврата уже осуществленных платежей можно использовать безкомиссионный интерфейс возврата Интерфейс X14, он работает с любыми платежами, принятыми с помощью данного интерфейса и возвращает средства либо на кошелек плательщика, либо на его мобильный телефон WebMoney чека.

Описание ошибок, возвращаемых интерфейсом:

см. также XML-интерфейсы

Ролик, демонстрирующий оплату через X20

Категория: XML-интерфейсы, Прием платежей

This article in other languages: English