Описание XML-интерфейсов системы

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

Для работы с XML-интерфейсами системы необходимо производить обращение к специальным сертификационным веб-серверам системы. Все интерфейсы, использующие аутентификацию с ключами WM Keeper Classic расположены по адресу https://w3s.webmoney.ru/asp/XML*.asp. Интерфейсы использующие аутентификацию со стандартными сертификатами (сертификаты WM Keeper Light) расположены по адресу https://w3s.wmtransfer.com/asp/XML*Cert.asp.

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

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

1. Структура запроса с аутентификацией по ключам WM Keeper Classic (подпись запроса формируется с помощью модуля WMSigner) <w3s.request> <reqn></reqn> - номер запроса <wmid></wmid> - WM идентификатор подписавшего запрос <sign></sign> - подпись запроса сформированная с помощью модуля WMSigner <тип_запроса> ... - параметры запроса </тип_запроса> </w3s.request>
2. Структура запроса с аутентификацией по стандартным сертификатам WM Keeper Light (параметры wmid и sign не используются; сертификат WMID, который вызывает интерфейс должен использоваться при установлении соединения с сервером). Более подробную информацию об использовании сертификатов смотрите на msdn.microsoft.com <w3s.request> <reqn></reqn> - номер запроса <тип_запроса> ... - параметры запроса </тип_запроса> </w3s.request>

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

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

• Назначение и описание порядка использования модуля аутентификации
• Интерфейс X1. Выписывание счета от одного участника (магазина, ресурса) другому участнику (покупателю) системы.
• Интерфейс X2. Перевод средств с одного кошелька на другой.
• Интерфейс X3. Получение истории операций по кошельку. Проверка выполнения операции по переводу средств между кошельками.
• Интерфейс X4. Получение истории выписанных счетов по кошельку. Проверка оплаты счета.
• Интерфейс X5. Завершение операции с протекцией сделки. Ввод кода протекции.
• Интерфейс X6. Отправка сообщения произвольному WM-идентификатору по внуренней почте WMT.
• Интерфейс X7. Идентификация и аутентификация клиента - владельца WM Keeper Classic на стороннем сайте.
• Интерфейс X8. Получение информации о принадлежности кошелька WM-идентификатору. Поиск участника системы по его идентификатору или кошельку.
• Интерфейс X9. Получение информации о балансе на кошельках.
• Интерфейс X10. Получение списка счетов на оплату.
• Интерфейс X11. Получение информации из аттестата клиента по ВМ-идентификатору.
• Интерфейс X12. Импорт выписки по кошельку в Документ программ семейства "1С Предприятие 7.7
• Интерфейс Х13.Возврат незавершенного платежа с протекцией.
• Интерфейс Х14.Безкомиссионный возврат средств отправителю.
• Интерфейс X15. Просмотр и изменение текущих настроек управления «по доверию».
  
  
• Программное обращение к XML-интерфейсам системы из скриптов на языке PHP с использованием расширения CURL

Корневой сертификат системы WebMoney в PEM-формате (для использования с библиотекой CURL).