Click&Buy Merchant Interface

Описание интерфейса Click&Buy Merchant Interface

Интерфейс позволяет покупателю оплатить и получить товар на вашем веб-сайте одним кликом. Интерфейс доступен только для WMID с аттестатом продавца.

Содержание

• Основные термины
• Описание Click&Buy Merchant Interface
  • Алгоритм выполнения платежа
  • Формат URL для оплаты (Keeper Classic)
  • Формат URL для оплаты (Keeper Light)
  • Формат квитанции об оплате
  • Проверка квитанции об оплате
  • Проверка получателя товара
    • Идентфикация WM Keeper Classic на сайте
    • Идентфикация WM Keeper Light на сайте
• Тестирование сервиса Click&Buy Merchant Interface
• Пример использования Click&Buy Merchant Interface

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

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

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

Описание Click&Buy Merchant Interface

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

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

Для инициации платежа с использованием Click&Buy Merchant Interface продавец должен сформировать на своем сайте ссылку в формате, описанном ниже. Кликнув на нее покупатель загружает в свой WM Keeper информацию о предлагаемом товаре или услуге в диалоге запроса на выполнение соответствующего платежа. После нажатия кнопки оплатить кипер пересылает запрос на платеж на сервер системы WebMoney Transfer. В случае успешного проведения платежа сервер системы WebMoney Transfer возвращает киперу квитанцию на получение товара. Получив квитанцию, кипер открывает специальное окно и загружает в него страницу, на которой находится оплаченный товар. При этом WM Keeper передает на веб-сайт продавца квитанцию об оплате. В квитанции содержится информация о платеже, совершенном покупателем.

На основании информации, содержащейся в квитанции, продавец формирует страницу с проданным товаром.

Формат URL для оплаты (классик)

Для инициации платежа с использованием Click&Buy Merchant Interface продавец должен сформировать на своем сайте ссылку в специальном формате. Адрес ссылки зависит от версии кипера покупателя (WM Keeper Classic или WM Keeper Light) и используемого им языка.

Формат параметров, передаваемых в ссылке, для WM Keeper Classic:

Пример платной ссылки:

<a href="wmk:paylink
 ?url=<https://merchant.webmoney.ru/conf/pci_testlink.asp?G=0>
 &purse=R111111111111
 &amount=0.1
 &method=POST
 &desc=платная ссылка для теста
 &mode=test">платная ссылка
</a> 

Общий размер ссылки имеет ограничение, накладываемое протоколом HTTP. Кроме того, многие браузеры обрезают строки длиной больше 200-500 символов!

Формат URL для оплаты (лайт)

Формат ссылки для WM Keeper Light похож на формат ссылки для WM Keeper Classic, но имеет некоторые существенные отличия.

Во-первых, адрес ссылки для оплаты товара зависит от языка, который использует покупатель.

Во-вторых, есть отличия в формате параметров.

 https%3A//merchant.webmoney.ru/conf/pci_testlink.asp%3FA%3D1%26b%3D1 

Пример платной ссылки:

 
<a href="https://light.wmtransfer.com/pci.aspx
 ?url=https%3A//merchant.webmoney.ru/conf/pci_testlink.asp%3FG%3D
 &purse=R111111111111 &amount=0.1
 &method=POST
 &desc=платная ссылка для теста
 &mode=test">платная ссылка</a> 

Общий размер ссылки имеет ограничение, накладываемое протоколом HTTP. Кроме того, многие браузеры обрезают строки длиной больше 200-500 символов!

Формат квитанции об оплате

Квитанция об оплате формируется сервером WebMoney Transfer в момент выполнения перевода и передается на веб-сайт продавца через WM Keeper покупателя при переходе по ссылке, переданной в параметре url методом, указанным в параметре method.

В квитанции передаются следующие поля:

Внимание!
Продавец обязательно должен предусмотреть проверку информации, присланной в “Квитанции об оплате”, в соответствии с рекомендациями следующего раздела — “Проверка квитанции об оплате”.

Проверка квитанции об оплате

При использовании Click&Buy Merchant Interface на веб-сайт продавца высылается квитанция об оплате, содержащая информацию о выполненном платеже и оплаченном товаре. Квитанция содержит подпись, которая формируется по следующему алгоритму:

sign=md5(pci_wmtid+WMID+md5(Upper(url+purse+amount+desc+mode))+ pci_pursesrc+pci_pursedest+pci_amount+pci_desc+pci_datecrt+mode+md5(passwd)),

где

• sign – подпись квитанции;
• md5 – способ формирования подписи MD5 (возвращает результат в верхнем регистре);
• passwd – пароль продавца в системе WebMoney Transfer;
• Upper – перевод строки в верхний регистр.

Для проверки продавец должен самостоятельно вычислить подпись, исходя из данных, полученных в квитанции и своего пароля, и сравнить вычисленную подпись с полученной в квитанции. Их идентичность позволяет убедиться в том, что квитанция действительно получена от Click&Buy Merchant Interface и данные квитанции не искажены.

После проверки подписи продавец должен выполнить следующие проверки:

1. Проверить сумму платежа.
2. Проверить описание товара (desc).
3. Проверить кошелек продавца.
4. Проверить режим проведения платежа (тестовый или реальный).

Проверка получателя товара

После проверки квитанции и содержащихся в ней данных о платеже продавец может идентифицировать WMID покупателя и убедиться, что веб-сайт посещает именно оплативший товар. WMID покупателя можно определить из параметра WMID, который передается на веб-сайт продавца кипером покупателя. Кроме того, можно убедится в том, что страницу открывает действительно указанный в параметре WMID, используя идентификацию клиента-владельца WM Keeper Classic или сравнивая значение параметра WMID со значением поля SUBJECTCN клиентского SSL сертификата для WM Keeper Light.

Идентификация WM Keeper Classic на сайте

Идентификация WM Keeper Classic основана на проверке подписи, выполненной WM Keeper . Интерфейс проверки подписи, сформированной WM Keeper Classic, приведен в статье Интерфейс X7.

В случае, если в URL, который должен открыть кипер после выполнения оплаты с использованием Click&Buy Merchant Interface, входит параметр sign_needed со значением post или get (например, sign_needed=post), кипер передает на веб-сервер следующие дополнительные параметры:

Перечисленные выше параметры передаются методом, указанным в параметре sign_needed (POST или GET).

Таким образом, для того чтобы убедится, что веб-сайт продавца посетил владелец указанного в поле WMID идентификатора, достаточно проверить подпись, полученную в поле SIGN. Для этого нужно сформировать строку, склеив текущий URL, дату подписи и WMID, полученный в параметре WMID, и передать ее.

Идентификация WM Keeper Light на сайте

Для надежной идентификации WMID владельца WM Keeper Light, на веб-сайте должен быть установлен серверный сертификат, выданный WebMoney Transfer, а сайт настроен на запрос клиентских сертификатов.

Тестирование сервиса Click&Buy Merchant Interface

Параметр “mode” позволяет продавцам тестировать интеграцию своего веб-сайта с сервисом Click&Buy Merchant Interface без выполнения реальных платежей. Если параметр установлен mode=test, сервис будет генерировать только тестовые платежи.

Параметр “Тестовый/Рабочий режимы” должен быть установлен в режим “тест” до тех пор, пока продавец не будет уверен в том, что его веб-сайт, интегрированный с сервисом Click&Buy Merchant Interface, работает правильно!

Пример использования интерфейса

Попробуйте оплатить, заплатив символическую плату – 0.01 WMR, и получить товар с интерфейсом Click&Buy Merchant Interface по ссылкам ниже.

Обращаем внимание на то, что при работе с WM Keeper Classic поле описания товара (pci_desc) указывется в кодировке Windows-1251, а при работе с WM Keeper Light – в кодировке UTF-8. Во избежание проблем с кодировкой для описания товара рекомендуется использовать английский текст.

Пример на языке PHP: скачать

См. также:
Merchant WebMoney Transfer
Web Merchant Interface
Пример оплаты товаров и услуг через сервис Merchant WebMoney Transfer

Категория: Сервисы системы, Прием платежей

This article in other languages: English