Перейти в режим автора

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

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

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

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

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

В случае аутентификации с использованием ключей WM Keeper WinPro в запросе передается подпись, сформированная модулем WMSigner. Сформированная подпись передается в параметре <sign>...</sign>.

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

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

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

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

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

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

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

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

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

Интерфейсы работают в кодировке windows-1251. При вызове рекомендуется передавать заголовки:
Content-Type: application/xml; charset=windows-1251
Accept: application/xml;charset=windows-1251

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

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

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