Управление WebMoney Keeper через WebMoney Keeper pluggable protocol (WMK)

В данном разделе описан интерфейс, используя который Вы можете посылать WM Keeper Classic определенные команды: обновить данные, показать окно, отправить сообщение и т.д.

Синтаксис этого протокола "внешне" напоминает синтаксис mailto:
Например, Вы можете поместить на своей странице следующую ссылку: Написать мне по WM-почте
HTML-код такой ссылки будет выглядеть следующим образом:

<a href="wmk:msgto?to=0636776357492&subject=Hi!&msg=Just a test :)&BringToFront=y">Написать мне по WM-почте</a>
Команды протокола WMK имеют следующий формат:
wmk:<команда>[?][параметр_1=значение]&[параметр_2=значение]&...[параметр_N=значение]

Есть параметры, которые могут принимать все команды протокола wmk. Ниже приведен список этих параметров.

Название параметра Принимаемые значения Описание
WMID WMID 12-цифр Команда будет обработана только тем экземпляром WebMoney Keeper (если их запущено несколько), в который вошли под указанным WMID.

Если этот параметр не указан - команда будет обработана всеми запущенными WebMoney Keeper.
BringToFront Y или N Если значение параметра установлено в Y, то после выполнения команды окно WebMoney Keeper будет отображено поверх остальных.
ExecEvenKeeperIsOffline Y или N По умолчанию команды протокола wmk выполняется только в режиме OnLine.
Если значение параметра установлено в Y, то команда будет обработана также и в режиме Offline.

Если WebMoney Keeper не был запущен, то он будет запущен автоматически.


Refresh
PayTo
MsgTo
Display
Explore
Exit

Команда Refresh делает то же самое, что и пункт меню WebMoney Keeper - Меню|Обновить данные.

Параметры
Не принимает дополнительных параметров.

Пример
Допустим с вашего сайта был выписан счет. Чтобы покупатель быстрее получил уведомление о нем, вы можете либо сделать ссылку Проверить получение счета, либо сделать autosubmit формы.

<a href="wmk:refresh">Проверить получение счета</a>



Команда PayTo показывает диалог "Передать WM". Параметры команды позволяют установить кошелек, на который будет производиться платеж, сумму и описание платежа.

Параметры
  • Purse - Номер кошелька на который будет производиться платеж;
  • Amount - Сумма платежа;
  • Desc - Описание платежа.
Пример
По этой ссылке можно Заплатить 100 WMZ на Ваш кошелек.

<a href="wmk:payto?Purse=Z123456789123&Amount=100&Desc=Test&BringToFront=Y">Заплатить 100 WMZ</a>



Команда MsgTo показывает диалог "Передать Сообщение". Параметры команды позволяют установить WMID адресата, тему и текст сообщения.

Параметры
  • To - WMID адресата;
  • Subject - Тема сообщения;
  • Msg - Текст сообщения.
Пример
Написать мне по WM-почте

<a href="wmk:msgto?to=0636776357492&subject=Hi!&msg=Just a test :)&BringToFront=y">Написать мне по WM-почте</a>



Команда Display позволяет показать окно, указанное в параметре Window, и передать ему в параметре Param данные для инициализации.

Параметры
  • Window - имя окна, которое будет показано.
    Параметр может принимать одно из значений, приведенных ниже:
    • Main - главное окно WebMoney Keeper Classic;
    • Options - диалог "Параметры программы";
    • Props - диалог "Информация о корреспонденте" или "О себе..." в зависимости от параметра Param;
    • About - диалог "О программе...";
    • Messages - диалог "Список всех сообщений";
    • Invoices_Out - окно "Список выписанных Вами счетов";
    • Invoices_In - окно "Список счетов, предъявленных Вам для оплаты";
    • Operations - окно "История операций".
  • Page - страница диалога (1 - первая страница, 2 - вторая и так далее), которая будет активной при показе диалога. Этот параметр применим к окнам Main, Options и Props.
  • Param - на данный момент этот параметр используется только окном Props. Вы можете передать в нем WMID участника системы, информация о котором будет показана в диалоге "Информация о корреспонденте". Если этот параметр отсутствует, то будет показан диалог "О себе..."
Пример
Показать WebMoney Keeper и открыть список кошельков
Кликните здесь, чтобы узнать версию WebMoney Keeper
Отредактируйте информацию о себе
Смените скин в этом диалоге!

a href=&qout;wmk:display?window=main&page=3&BringToFront=Y&qout;>Показать WebMoney Keeper и открыть список кошельков</a><br>

<a href=&qout;wmk:display?window=about&BringToFront=Y&qout;>Кликните здесь, чтобы узнать версию WebMoney Keeper</a><br>

<a href=&qout;wmk:display?window=props&BringToFront=Y&qout;>Отредактируйте информацию о себе</a><br>

<a href=&qout;wmk:display?window=options&page=1&BringToFront=Y&qout;>Смените скин в этом диалоге!</a><br>




Команда Explore показывает страницу, указанную в параметре URL в специальном окне WebMoney Keeper.

Параметры
  • URL - страница, которую надо показать;
  • Title - заголовок окна, в котором она будет показана.
Пример
А это пример из "боевого" сайта: Click Me :)

<a href="wmk:explore?url=http://mts.megastock.ru/asp/enternewmtspay.asp&BRINGTOFRONT=Y&title=Платеж на МТС через Мерчант без авторизации">Click Me :)</a><br>



Команда Exit просто позволяет предложить пользователю выйти из WebMoney Keeper.

Параметры
Не принимает дополнительных параметров.

Пример
Выйти из WebMoney Keeper

<a href="wmk:exit?BringToFront=Y">Выйти из WebMoney Keeper</a><br>



Воспроизводимые на данном сайте торговые марки WEBMONEY и WEBMONEY TRANSFER используются держателями сайта с разрешения правообладателя.
Copyright WebMoney © 1998.
сотрудничество | карьера | пресс-центр | контакты | вопросы и ответы | юридическая информация

По всем вопросам обращайтесь support.wmtransfer.com