Description of XML Interfaces

XML interfaces are basically text message interfaces that send data via HTTPS protocol (http over 128-bit SSL) to special certification web servers of the system. Data is sent in the XML format with help of special module for authentication of WebMoney Keeper key files or standard certificates (WM Keeper Light certificates).

Interfaces using WM Keeper Classic authentication are located at https://w3s.webmoney.ru/asp/XML*.asp. Interfaces using WM Keeper Light certificate authentication are located at https://w3s.wmtransfer.com/asp/XML*Cert.asp.

In case WM Keeper Classic authentication is used, the request submitted to the certification server passes a signature created in the same manner as for https interfaces. The signature is sent in the parameter: <sign>...</sign>
In case WM Keeper Light authentication is used, WM Keeper Light certificate is used when connecting to the server: https://w3s.wmtransfer.com. In this case the <sign>...</sign> parameter is not used.

Regardless of the authentication type, requests have similar format and differ only in the method of creation and transmission of signature. Below you will find samples of requests:

  1. Structure of a request based on WM Keeper Classic authentication (signature is created using WMSigner) <w3s.request> <reqn></reqn> - request number <wmid></wmid> - WMID of the signer <sign></sign> - signature created using WMSigner <request_type> ... - request parameters </request_type> </w3s.request>
  2. Structure of a request based on WM Keeper Light certificate authentication (Parameters wmid and sign should not be used; WMID's certificate should be used to connect to the server). You will find more information on certificates at msdn.microsoft.com <w3s.request> <reqn></reqn> - request number <request_type> ... - request parameters </request_type> </w3s.request>

In responding to a request, the server determines the data that needs to be returned. The structure of a response does not depend on the authentication type. Below you will find a sample response structure:

<w3s.response> <reqn></reqn> - number of the request the server is responding to <retval></retval> - error code: 0 - successfully performed <retdesc></retdesc> - error description if retval != 0 <response_type> ... - response parameters </response_type> </w3s.response>

The following interfaces can be used by online businesses:

WebMoney root certificate in the PEM format (to be used with CURL library)

The usage of WEBMONEY and WEBMONEY TRANSFER graphic logos by the site holders is authorized by trademark owners.
Copyright WebMoney © 1998.
Contact Us  |  Help  |  Terms of Use

For all questions please contact us WebMoney Technical Support