XML-интерфейсы

XML-интерфейсы предназначены для использования в программах сторонних разработчиков.

В данном разделе представлены интерфейсы системы, основанные на обращениях (запросах) к специальному Web-серверу системы по протоколу https (SSL 128 бит) в формате XML с использованием специального модуля аутентификации для ключей WM Keeper Classic или стандартных сертификатов x.509 (сертификаты WM Keeper Light).

Описание XML-интерфейсов зачисления WMZ и WME смотрите в отдельной статье.

Все интерфейсы, использующие аутентификацию с ключами WM Keeper Classic имеют адрес вида https://w3s.webmoney.ru/asp/XML_название_.asp. Интерфейсы использующие аутентификацию со стандартными сертификатами (сертификаты WM Keeper Light) – https://w3s.wmtransfer.com/asp/XML_название_Cert.asp.

В случае аутентификации с использованим ключей WM Keeper Classic в запросе передается подпись, сформированная модулем WMSigner. Сформированная подпись передается в параметре <sign>…</sign>.
В случае аутентификации с использованием сертификатов WM Keeper Light, сертификат должен использоваться при установлении соединения с сервером https://w3s.wmtransfer.com. Параметр <sign>…</sign> в этом случае в запросе не используется.

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

Вне зависимости от типа используемой аутентификации, формат запросов одинаков и отличается только способом формирования и передачи подписи запроса. Ниже приведены примеры структуры запросов с различными типами аутентификации:

Структура запроса с аутентификацией по ключам WM Keeper Classic (подпись запроса формируется с помощью модуля WMSigner)

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

Структура запроса с аутентификацией по стандартным сертификатам WM Keeper Light (параметры wmid и sign не используются; сертификат WMID, который вызывает интерфейс должен использоваться при установлении соединения с сервером). Более подробную информацию об использовании сертификатов смотрите на http://msdn.microsoft.com

<w3s.request>
	<reqn></reqn> - номер запроса
	<тип_запроса>
		... - параметры запроса
	</тип_запроса>
</w3s.request>

Формат ответа системы не зависит от способа аутентификации запроса. Ниже приведен пример структуры ответа сервера:

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

Имена файлов интерфейсов и перечень параметров запросов и ответов приведены в описании каждого интерфейса:

• Назначение и описание порядка использования модуля аутентификации WMSigner.
• Интерфейс X1. Выписывание счета от одного участника (магазина, ресурса) другому участнику (покупателю) системы.
• Интерфейс X2. Перевод средств с одного кошелька на другой.
• Интерфейс X3. Получение истории операций по кошельку. Проверка выполнения операции по переводу средств между кошельками.
• Интерфейс X4. Получение истории выписанных счетов по кошельку. Проверка оплаты счета.
• Интерфейс X5. Завершение операции с протекцией сделки. Ввод кода протекции.
• Интерфейс X6. Отправка сообщения произвольному WM-идентификатору по внутренней почте WMT.
• Интерфейс X7. Идентификация и аутентификация участника – владельца WM Keeper Classic на стороннем сайте.
• Интерфейс X8. Получение информации о принадлежности кошелька WM-идентификатору. Поиск участника системы по его идентификатору или кошельку.
• Интерфейс X9. Получение информации о балансе на кошельках.
• Интерфейс X10. Получение списка счетов на оплату.
• Интерфейс X11. Получение информации из аттестата владельца по WM-идентификатору.
• Интерфейс X12. Импорт выписки по кошельку в Документ программ семейства “1С Предприятие 7.7”
• Интерфейс X13. Возврат незавершенного платежа с протекцией.
• Интерфейс X14. Безкомиссионный возврат средств отправителю (покупателю).
• Интерфейс X15. Просмотр и изменение текущих настроек управления “по доверию”.
• Интерфейс X16. Создание кошелька.
• Интерфейс X17. Операции с контрактами сервиса Арбитража.
• Интерфейс X18. Получение деталей операции через merchant.webmoney.
• Интерфейс X19. Проверка соответствия персональных данных владельца WM-идентификатора.
• Интерфейс X20. Проведение транзакции в merchant.webmoney без ухода с сайта (ресурса, сервиса, приложения) продавца.

Библиотеки для работы с XML-интерфейсами

См. также:
XML-интерфейсы зачисления WMZ и WME
Корневой сертификат WebMoney
Ext WMKeeper
Разъяснение правил для систем активной рекламы
Конвертация ключей WM Keeper Light в PEM-формат

Категория: XML-интерфейсы

This article in other languages: English