Permalink:

Interface X9

Interface X9. Retrieving information about purse balance.¶

There is an analog for this interface, JSON interface with JWT authorization, which does not require a special authentication module for WM Keeper WinPro keys or x.509 certificates.

This interface is available only to registered clients. This interface is only available for registered clients who also added X2 interface

Requests using WM Keeper WinPro authorization should be sent to: - https://w3s.web.money/asp/XMLPurses.asp
Requests using WM Keeper WebPro authorization should be sent to - https://w3s.wmtransfer.com/asp/XMLPursesCert.asp
Method - POST
Request format:

<w3s.request>
    <reqn></reqn>
    <wmid></wmid>
    <sign></sign>
    <getpurses>
        <wmid></wmid>
    </getpurses>
</w3s.request>

Request parameters:

name	purpose	comments
reqn	Request number	An integer without delimiter, max 15 digits; This value must always be greater than the number of the previous purse balance request!!!
wmid	Signer's WMID	Used only with WM Keeper WinPro authorization method
sign	Request signature - takes the following parameters: getpurses/wmid+reqn	Used only with WM Keeper WinPro authorization method
getpurses	Request parameters
getpurses\wmid	WM-identifier	12 digits

Response format:

<w3s.response>
    <reqn></reqn>
    <retval></retval>
    <retdesc></retdesc>
    <purses cnt="n">
        <purse id="n">
            <pursename></pursename>
            <amount></amount>
        </purse>
        <purse>
        ...
        </purse>
    </purses>
</w3s.response>

Response parameters:

name	purpose	comments
reqn	Request number
retval	Request execution code	0 - Request successful
retdesc	Description of request execution code
purses	The list of purses, retrieved by the request	cnt attribute - number of purses of the specified identifier
purses\purse	Purse parameters	id attribute - WM purse unique internal number
purse\pursename	WM purse number	a letter+12 digits
purse\amount	Amount on WM purse
purse\desc	short description of the purse
purse\outsideopen		0/1
purse\lastintr
purse\lastouttr

Execution/Error Codes:

Code	Description
-100	General parsing error. Incorrect request format. (XMLParser error - "+reason+" Request.TotalBytes:"+Request.TotalBytes)
-110	Requests are sent from a different IP address than the one specified ison the Web Merchant Interface settings page in the "Advanced parameters" table"
-1	Invalid invalid relying`s identifier
-2	invalid WMID for verification
-3	invalid signature
-5	invalid signature:'+PlanStr
110	No access to interface
111	Attempt to request a balance from a WM purse which does not belong to the WMID used to sign the request; Security trust has not been established