WebMoney eXpert - Информационный портал о системе WebMoney.
На главнуюКонтактыКарта сайта Обмен WM, RBK, Yandex   |   Обмен SMS на WebMoney   |   Мониторинг обменников   |   Реклама на сайте
Меню
Счетчики



Главная страница Для разработчиков FAQ по XML интерфейсам

Реклама за WebMoney. Топ.

Купить это место!


Обмен WM, YAD, RBK

Моментальный онлайн обмен WebMoney, Yandex.Деньги и RBK Money по максимально низким курсам! Также, в системе действует накопительная система скидок.

wmx.ru
  Ваш продукт захотят!

Реклама в блогосфере и социальных сетях — это современный способ продвижения товаров и услуг, недорогой и эффективный.

blogun.ru
  WebMoney за SMS

Сервис быстрого пополнения R, Z, U или E кошелька WebMoney через SMS.

wmx.ru
FAQ по XML интерфейсам
  1. Что такое XML?
  2. Как и для чего XML-интерфейсы применяются в WebMoney?
  3. Что нужно знать для работы с XML интерфейсами WebMoney?
  4. Перечень XML-интерфейсов WebMoney.
  5. Как происходит аутентификация с использованием ключей WM Keeper Classic?
  6. Структура запроса с аутентификацией по ключам WebMoney Keeper Classic.
  7. Как происходит аутентификация с использованием сертификатов WM Keeper Light?
  8. Структура запроса с аутентификацией по сертификатам WebMoney Keeper Light.
  9. Структура ответа сервера WMT.
  10. Что такое WMSigner?
  11. Что такое WMSignerFX?
  12. Что нужно для использования модуля WMSigner?
  13. Как получить модуль WMSigner?
  14. Как установить модуль WMSigner?
  15. Keys Extractor - кодирует представление ключей в формате Base64. Где скачать эту программу и как с ней работать?
  16. Подробнее о WMSigner.ini.
  17. Как правильно и безопасно расположить WMSigner и файл ключей на сервере?
  18. Применение XML интерфейсов в Telepat.
  19. Применение XML интерфейсов в Paymer.
  20. XML и массовые платежи.  
1. Что такое XML?

Ключевые слова в определении XML - это "хранение" и "обмен". Язык разметки XML был создан для хранения структурированных данных и для обмена информацией между программами. XML используется для автоматизации различных процессов, например, для автоматической отправки сообщений пользователю.

Подробно о понятии XML можно узнать здесь.

2. Как и для чего XML-интерфейсы применяются в WebMoney?

XML-интерфейсы в WebMoney представляют из себя различные варианты запросов (обращений) к серверу WebMoney Transfer.
Запрос производится по защищенному протоколу https (SSL 128 бит) и невозможен без использования модуля аутентификации для ключей WebMoney Keeper Classic, либо для сертификатов WM Keeper Light.

https://w3s.webmoney.ru/asp/XML*.asp - адрес сервера для работы с XML интерфейсами через WM Keeper Classic
https://w3s.wmtransfer.com/asp/XML*Cert.asp - адрес сервера для работы с XML интерфейсами через WM Keeper Light.

XML интерфейсы в WebMoney оптимально использовать для:
- отправки сообщений по внутренней почте WebMoney Transfer;
- осуществления выплат участникам Вашего проекта;
- организации моментальных выплат online-лотерей и игр;
- проверки корректности ввода WMID пользователями;
- запроса баланса кошельков;
- и т.д.

3. Что нужно знать для работы с XML интерфейсами WebMoney?

Во-первых, потребуется некоторая атрибутика WebMoney Transfer. Речь идет о наличии персонального аттестата платежной системы. Справедливое решение разработчиков. Кроме того, нужно определиться, будете Вы работать с ключами WM Keeper Classic или же сертификатами WM Keeper Light.

Во-вторых, потребуются определенные знания:
- знание PHP-программирования;
- понимание работы сервера, на котором расположен Ваш сайт (права доступа, ftp, shell, методы post и get);
- понимание работы XML.
 

4. Перечень XML интерфейсов WebMoney:
  • интерфейс X1 - позволяет выписывать счет;
  • интерфейс Х2 - позволяет переводить денежные средства;
  • интерфейс Х3 - для просмотра истории операций по кошельку;
  • интерфейс Х4 - для получения истории выписанных счетов по кошельку;
  • интерфейс Х5 - дает возможность завершить операцию с использованием протекции (ввод кода протекции);
  • интерфейс Х6 - обеспечивает отправку сообщений по внутренней WM-почте;
  • интерфейс Х7 - идентифицирует участника системы WMT на стороннем сайте;
  • интерфейс Х8 - предоставляет информацию о принадлежности электронного кошелька WM-идентификатору, а также производит поиск участников платежной системы по кошельку или WMID;
  • интерфейс Х9 - предоставляет информацию о балансе кошелька;
  • интерфейс Х10 - выдает список счетов на оплату;
  • интерфейс Х11 - показывает информацию об аттестате клиента по WMID;
  • интерфейс Х12 - импортирует выписку по кошельку в Документ программ семейства "1С Предприятие 7.7";
  • интерфейс Х13 - возвращает незавершенный платеж с протекцией;
  • интерфейс Х14 - обеспечивает безкомиссионный возврат средств отправляющей стороне;
  • интерфейс Х15 - для просмотра и редактирования настроек управления "по доверию";
  • интерфейс Х16 - для создания кошелька.

Все перечисленные интерфейсы подробно описаны на официальном сайте платежной системы и на сайте wiki.webmoney.ru.

5. Как происходит аутентификация с использованием ключей WM Keeper Classic?

В процессе аутентификации с использованием ключей WM Keeper Classic происходит обращение к серверу WMT. При этом через запросы передается подпись, сформированная аналогично применению https-интерфейсов. Для передачи сформированной подписи используется параметр <sign>...</sign>.

6. Структура запроса с аутентификацией по ключам WebMoney Keeper Classic.

Подпись запроса формируется при помощи модуля WMSigner. Структура выглядит следующим образом:

<w3s.request>
<reqn></reqn> - номер запроса
<wmid></wmid> - идентификатор подписавшего запрос
<sign></sign> - подпись запроса, сформированная при помощи модуля WMSigner
<тип запроса>
... - параметры запроса
</тип запроса>
</w3s.request>

7. Как происходит аутентификация с использованием сертификатов WM Keeper Light?

Аутентификация с использованием сертификатов WM Keeper Light происходит через сервер WMT, используя адрес https://w3s.wmtransfer.com/asp/XML*Cert.asp. В этом случае параметр <sign>...</sign> не применяется.

8. Структура запроса с аутентификацией по сертификатам WebMoney Keeper Light.

Параметры wmid и sign - не используются.
<w3s.request>
<reqn></reqn> - номер запроса
<тип запроса>
... - параметры запроса
</тип запроса>
</w3s.request>

9. Структура ответа сервера WMT.

Универсальна для WM Keeper Classic и WM Keeper Light.

<w3s.response>
<reqn></reqn> - номер запроса, на который высылается ответ
<retval></retval> - код ошибки выполнения запроса: 0 - выполнен успешно
<retdesc></retdesc> - описание ошибки, если retval !=0
<тип ответа>
... - параметры ответа
</тип ответа>
</w3s.response>

10. Что такое WMSigner?

WMSigner - это модуль, формирующий электронно-цифровую подпись (ЭЦП), которая используется для аутентификации при работе с XML интерфейсами WebMoney Transfer.

11. Что такое WMSignerFX?

WMSignerFX - это кодовое название модуля WMSigner, применяемого для .Net платформы. Этот вариант имеет весомые преимущества:

- модуль очень просто ставится на сервере (без регистрации и без присвоения специальных прав);
- файл ключей и пароль для восстановления ключей не нужно хранить на сервере (для этого используется строковое представление ключей в формате Base64);
- есть возможность работы с разными ОС (Windows, Unix, Linux, Mac OS X, Solaris);
- модуль работает в несколько раз быстрее.

12.Что нужно для использования модуля WMSigner?
  • Иметь возможность размещения и запуска бинарного модуля WMSigner на компьютере (в случае, если это сторонний веб-сервер, который предоставляет услуги хостинга для веб-ресурса, необходимо договориться об этом с провайдером хостинга);
  • Иметь возможность размещения на компьютере файла с ключами от WM-идентификатора ресурса (название файла по умолчанию: keys.kwm).
  • Использовать резервную копию ключей и пароль (код доступа к ключу) от резервной копии ключей (размер 164 байта) . При этом вы должны максимально защитить файл с ключами, предварительно проконсультировавшись у администратора компьютера (или провайдера хостинга). Помните, что ваши файлы с ключами остаются доступными, как минимум, администратору компьютера (провайдеру хостинга). Помните, файла с ключами и пароля (который также будет расположен на компьютере) достаточно для того, чтобы получить полный доступ к средствам на кошельках. Возможно, будет необходимо продумать схему ежедневного перевода накапливающихся на кошельке ресурса средств на другой кошелек, расположенный в недоступном для посторонних месте;
  • Иметь возможность размещения файла WMSigner.ini в директории, где находятся WMSigner.
13. Как получить модуль WMSigner?

Пользователям предоставлена возможность получить модуль WMSigner в виде исходного когда, который нужно будет скомпилировать на платформе, где он будет запускаться.

Модуль WMSigner доступен для скачивания здесь.

Стоит отметить, что модуль поставляется и в других видах:
- в виде исполняемого бинарного файла (для Win32);
- в виде ActiveX-объекта (только для Win32).
Но разработчики WMT советуют использовать первый вариант поставки модуля (в виде исходного когда с последующей компиляцией).

14. Как установить модуль WMSigner?

Разработчики WMT настоятельно рекомендуют при использовании UNIX-платформ копмилировать модуль самостоятельно.
Для компиляции скаченного кода, необходимо выполнить следующую команду:

$ make

Этой командой создается выполняемый модуль WMSigner. Вполне вероятно возникновение ошибок - нужно будет установить необходимые библиотеки.

Скомпилировав исходный код, перепишите его в директорию Вашего сервера и создайте права на его выполнение.

Разработчики WM приводят примерный код, как это должно выглядеть:
chmod a+x ./WMSigner

В директорию с установленным скриптом закачивется файл WMSigner.ini. Это файл настройки, требующий установки прав на чтение. Поскольку WMSigner будет запускаться http-сервером, можно ставить права на чтение всем:
chmod a+r ./WMSigner.ini

Аналогичные права необходимо установить и на файл ключей:
chmod a+r /ваш_путь/keys.kwm

Подробнейшая инструкция по установке модуля WMSigner - здесь.

15. Keys Extractor - создает представление ключей в формате Base64. Где скачать эту программу и как с ней работать?

Все верно. Программа Keys Extractor создает представление ключей WM Keeper Classic в формате Base64, которое хранится на сервере в конфигурационном файле с закрытым доступом.

Скачать Keys Extractor можно здесь (это архив).
Пароль к архиву пользователь может получить лишь на свой WebMoney Keeper при выполнении главного условия - нужен персональный аттестат WMT. Заказ пароля к скаченному архиву производится по внутренней WM-почте на WMID 301095414760.

Утилита Keys Extractor имеет предельно понятный интерфейс.

16. Подробнее о WMSigner.ini.

WMSigner.ini - это файл настройки WMSigner, он определяет местонахождение на сервере файла ключей и WMID, которым будет подписана строка, передаваемая модулю WMSigner, и пароль к нему (код доступа к файлу ключей).

Структура файла WMSigner.ini:

[WMID магазина]
[пароль]
[путь к файлу ключей + имя файла]

17. Как правильно и безопасно расположить WMSigner и файл ключей на сервере?

- Располагайте модуль WMSigner, файл WMSigner.ini и файл ключей в каталоге, недоступном для скачивания.
- Не стоит пользоваться услугами провайдеров, предоставляющих консольный доступ, либо если Вы можете зайти в директорию любого пользователя данного поставщика хостинг-услуг.

Располагая файлы на сервере, необходимо учесть следующее:

- Файл WMSigner.ini ищет модуль подписи в том же каталоге, где расположен сам;
- Модуль WMSigner ищет файл ключей так, как это задано в WMSigner.ini, причем за "текущий каталог" принимается каталог расположения скрипта, вызывающего модуль WMSigner.

Разработчики WMT приводят следующий пример:

Каталог скриптов и html-документов: /home/my_site/html
Каталог расположения WMSigner: /home/my_site/sign
Конфигурационный файл: /home/my_site/sign/WMSigner.ini :
123456789012
pass
/home/my_site/sign/keyfile.kwm

18. Применение XML интерфейсов в Telepat.

В данном случае XML интерфейсы WebMoney применяются при разработке Интернет-магазинов для выписывания счетов на оплату сервиса Telepat с последующей проверкой оплаты. XML интерфейсы также используют 128-битный SSL в сочетании с собственным модулем аутентификации (речь идет о работе с WM Keeper Classic).

Используются три XML интерфейса:
1. Интерфейс, выписывающий счет на оплату.
2. Интерфейс, проверяющий оплату счета.
3. Интерфейс, обеспечивающий поиск пользователя сервиса по номеру телефона.

Подробное описание использования каждого типа XML интерфейсов можно узнать здесь.

19. Применение XML интерфейсов WebMoney в Paymer.

Благдаря XML интерфесам стало возможным проводить операции погашения чеков автоматически чепрез POST запрос с последующей проверкой результата выполнения операции.

Подробное описание функционирования XML интерфейсов в Paymer приведено здесь.

20. XML и массовые платежи.

Сервис массовых платежей позволяет производить платежные операции с кошельков авторизованного WMID. Конечно же без XML здесь не обошлось. Для работы с данным сервисом необходимо подготовить файл-задачу со списком необходимых переводов в формате XML. Подробное описание, в т.ч. и XML-структура приведены здесь.
 

Реклама за WM.

Купить это место! <<< | >>> Другие рекламные места нашего сайта
Реклама

Сдаётся



Хотите разместить рекламу?
Рекомендуем

WMX.RU - обмен SMS на WebMoney; бонусы WMZ, WMR, WMU, WME (WebMoney)

Материалы, размещенные на страницах проекта WebMoney eXpert, были написаны создателями или по заказу создателей и, в единичных случаях, собраны из открытых источников или присланы пользователями. На все материалы, которые были присланы или взяты с других ресурсов есть ссылка на источник. Если Вы считаете, что какие-либо тексты, фото или статьи нарушают чьи-то авторские права, пожалуйста, свяжитесь с администратором проекта, и мы разместим "копирайт", либо удалим материал. Все наши реквизиты можно найти в разделе контакты.



Студия "Виртуоз" 2003 - 2015