Описание интерфейса сервиса Web Merchant Interface¶

дата последнего изменения: 11 июля 2025

Содержание¶

• Основные термины
• Описание Web Merchant Interface
  • Параметры приема платежей
  • Алгоритм выполнения платежа
  • Формы HTML
    • Форма запроса платежа
    • Форма предварительного запроса
    • Форма оповещения о платеже
    • Форма выполненного платежа
    • Форма невыполненного платежа
  • Проверка информации о платеже
    • Проверка источника данных
    • Проверка целостности данных
    • Контрольная подпись данных о платеже
    • Проверка контрольной подписи
    • Проверка суммы платежа
    • Проверка кошелька продавца
    • Проверка режима платежа
    • XML-интерфейс выяснения состояния платежа по LMI_PAYMENT_NO
• Тестирование сервиса Web Merchant Interface
• Примеры использования интерфейса
• История платежей и бескомиссионный возврат
• Оповещение об ошибке платежа

Основные термины¶

Продавцом считается участник WebMoney Transfer, принимающий на свой WM-кошелек оплату от других участников системы с помощью сервиса Web Merchant Interface. Предполагается, что продавец принимает оплату за товары или услуги, предоставляемые им через Интернет, и следовательно, имеет собственный веб-сайт.

Покупателем считается участник WebMoney Transfer, желающий оплачивать услуги или товары, предлагаемые продавцом через Интернет.

Описание интерфейса Web Merchant Interface¶

ПАРАМЕТРЫ ПРИЕМА ПЛАТЕЖЕЙ¶

Помимо регистрации в WebMoney Transfer для приема платежей через сервис Web Merchant Interface продавец должен настроить ряд параметров, регулирующих порядок приема платежей и оповещения продавца о факте проведения платежа.

Настройка параметров выполняется на странице Настройки сайта сервиса — merchant.webmoney.com.

Для каждого кошелька, на который продавец принимает платежи, в сервисе хранится свой набор значений.

Полный перечень параметров и их назначение приведено ниже:

Алгоритм выполнения платежа¶

Алгоритм выполнения платежа представлен на рисунке ниже.

ФОРМЫ HTML¶

Для передачи информации между веб-сайтом продавца и сервисом Web Merchant Interface используютcя пять основных HTML-формы:

• Форма запроса платежа - генерируется веб-сайтом продавца для формирования запроса на проведение платежа в сервисе Web Merchant Interface и передачи его через веб-браузер покупателя.
• Форма предварительного запроса - генерируется сервисом Web Merchant Interface для передачи параметров предварительного запроса на выполнение платежа на веб-сайт продавца, если установлен флаг Передавать параметры в предварительном запросе. Если флаг не установлен - не используется (запрос выполняется без параметров). Запрос передается без использования веб-браузера покупателя.
• Форма оповещения о платеже - генерируется сервисом Web Merchant Interface для передачи оповещения о платеже на веб-сайт продавца. Оповещение передается без использования веб-браузера покупателя.
• Форма выполненного платежа - генерируется сервисом Web Merchant Interface в случае успешного выполнения платежа и передается на веб-сайт продавца через веб-браузер покупателя.
• Форма невыполненного платежа - генерируется сервисом Web Merchant Interface в случае невыполнения платежа и передается на веб-сайт продавца через веб-браузер покупателя.

Форма запроса платежа¶

Эта форма передает запрос с веб-сайта продавца в сервис Web Merchant Interface через веб-браузер покупателя. Она должна иметь следующие атрибуты и поля:

Action - https://merchant.webmoney.com/lmi/payment_utf.asp

Method - POST

accept-charset - UTF-8

content-type - application/x-www-form-urlencoded

Fields - поля, передаваемые в форме, описаны в таблице ниже:

 LMI_PAYEE_PURSE;LMI_PAYMENT_AMOUNT;LMI_PAYMENT_NO;Secret Key X20;

 LMI_PAYEE_PURSE;LMI_PAYMENT_AMOUNT;LMI_HOLD;LMI_PAYMENT_NO;Secret Key X20;

* - Только один из параметров LMI_PAYMENT_DESC или LMI_PAYMENT_DESC_BASE64 должен присутствовать обязательно!

В поле Action формы у продавца всегда есть возможность спозиционировать покупателя сразу же на какой то определенный способ (вариант) оплаты. Это очень удобно, когда продавец полноценно реализует подключение магазина со всеми возможными опциями. Для этого служит параметр at в URL запроса, например, если произвести передачу платежной формы по URL https://merchant.webmoney.com/lmi/payment_utf.asp?at=authtype_8, то покупатель будет сразу же спозиционирован на оплату с WebMoney кошелька, а если at=authtype_3, то с WebMoney карты. Если данный параметр не указан, то покупателю автоматически выбирается способ, который он выбрал и использовал при предыдущей оплате. Все доступные способы позицинирования перечислены ниже:

• authtype_2 Keeper WebPro
• authtype_3 WebMoney-карта/Чек Paymer (настоятельно рекомендуем, если на сайте продавца платеж скретч ВМ-картой/чеком Paymer вынесен в отдельный пункт, сразу спросить у покупателя номер ВМ-карты/чека Paymer и передать его в параметре LMI_PAYMER_PINNUMBERINSIDE , в этом случае позиционирование будет не нужно и покупатель сразу попадет на нужную страницу, минуя этап выбора способа платежа и ввода номера ВМ-карты/чека Paymer)
• authtype_8 Keeper WinPro
• authtype_9 Keeper Standard
• authtype_13 WebMoney чек
• authtype_17 быстрый платеж с указанием мобильного телефона (если продавцу известен номер мобильного телефона покупателя в международном формате, то он может передать его в параметре LMI_FAST_PHONENUMBER и в этом случае покупателю не нужно будет вводить его у нас на сайте при проведении быстрого платежа)
• authtype_20 Bitcoin
• authtype_22 RunPay MDL
• authtype_26 Litecoin
• authtype_27 Ethereum
• authtype_28 USDT

Обратите внимание, что данный способ позиционирования метода оплаты, работает только для покупателей, которые не авторизованы. Если покупатель был авторизован ранее, и Вы хотите переопределить способ оплаты, то необходимо работать с параметром LMI_ALLOW_SDP

Пример 1. Фрагмент "Формы запроса платежа" без замены URL

 
<html> 
<head>
 ... 
</head> 
<body> ...
<form method="POST" action="https://merchant.webmoney.com/lmi/payment_utf.asp" accept-charset="utf-8">  
  <input type="hidden" name="LMI_PAYMENT_AMOUNT" value="12.08">
  <input type="hidden" name="LMI_PAYMENT_DESC" value="платеж по счету">
  <input type="hidden" name="LMI_PAYMENT_NO" value="1234">
  <input type="hidden" name="LMI_PAYEE_PURSE" value="Z145179295679">
  <input type="hidden" name="LMI_SIM_MODE" value="0">
  <input type="hidden" name="FIELD_1" value="VALUE_1">
  <input type="hidden" name="FIELD_2" value="VALUE_2">
  ... 
  <input type="hidden" name="FIELD_N" value="VALUE_N"> 
  ... 
</form>
... 
</body>
</html>

Пример 2. Фрагмент "Формы запроса платежа" с заменой URL

<html>
<head>
 ... 
</head> 
<body> 
... 
<form method="POST" action="https://merchant.webmoney.com/lmi/payment_utf.asp" accept-charset="utf-8">
  <input type="hidden" name="LMI_PAYMENT_AMOUNT" value="12.08">
  <input type="hidden" name="LMI_PAYMENT_DESC" value="платеж по счету">
  <input type="hidden" name="LMI_PAYMENT_NO" value="1234">
  <input type="hidden" name="LMI_PAYEE_PURSE" value="Z145179295679">
  <input type="hidden" name="LMI_SIM_MODE" value="0">
  <input type="hidden" name="LMI_RESULT_URL" value="http://www.shop.com/result.asp">
  <input type="hidden" name="LMI_SUCCESS_URL" value="http://www.shop.com/success.html">
  <input type="hidden" name="LMI_SUCCESS_METHOD" value="2">
  <input type="hidden" name="LMI_FAIL_URL" value="http://www.shop.com/fail.html">
  <input type="hidden" name="LMI_FAIL_METHOD" value="2">
  <input type="hidden" name="FIELD_1" value="VALUE_1">
  <input type="hidden" name="FIELD_2" value="VALUE_2">
  ...
  <input type="hidden" name="FIELD_N" value="VALUE_N">
  ... 
</form>
 .. 
</body> 
</html>

Обратите внимание на ОБРАЗЦОВУЮ реализацию формы запроса платежа в магазине Плати.ру , в котором реализованы все возможности выбора способов платежа и прямого позиционирования покупателя на нужный способ с уже имеющимися данными.

Другой способ создания формы платежа предоставляет XML-интерфейс X22. С его помощью можно предварительно зафиксировать параметры платежа и сразу получить универсальную ссылку, которая может быть передана любыми способами связи. Такая ссылка обеспечивает несколько вариантов безопасного платежа: в мобильном WM Keeper, считав QR-код, или перейдя по ссылке из мобильного браузера; в браузере на десктопе — с помощью обычной формы платежа с заранее установленными параметрами.

Холдирование платежа¶

Холдирование платежа (блокировка средств) позволяет выполнить мгновенный возврат средств без потерь на комиссию покупателя и продавца. В течении срока холдирования продавец может выполнить зачисление средств через сайт или используя соответствующее API. Если продавец не провел зачисление средств, то по завершению срока холдирования, они возвращаются на кошелек покупателя автоматически.

Параметр LMI_HOLD - срок холдирования платежа. Если данный параметр передан, то совершается транзакция с протекцией по времени на указанное количество суток. Для зачисления средств продавец должен завершить операцию с сайта merchant.webmoney.com или вызвать XML-интерфейс, если продавец не сделает данных действий, то по истечении указанного срока средства возвращаются плательщику.
Досрочный возврат выполняется на странице merchant.webmoney.com или через XML-интерфейс
Данный способ доступен только при совершении платежа с кошелька WebMoney
Использование данного параметра возможно только если используется подпись формы запрос платежа!

Форма предварительного запроса¶

Эта форма передает продавцу параметры выполняемого платежа непосредственно перед его выполнением. Она имеет следующие атрибуты и поля:

Action - Result URL

Method - POST

Fields - поля, передаваемые в форме, описаны в таблице ниже: