Permalink:

Interface X16

Interface X16. Creating a purse.¶

This interface allows creating a new purse with the specified name and type.

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.webmoney.ru/asp/XMLCreatePurse.asp
Requests using WM Keeper WebPro authorization should be sent to https://w3s.wmtransfer.com/asp/XMLCreatePurseCert.asp
Method - POST
Request format:

<w3s.request>
  <reqn></reqn>
    <wmid></wmid>
    <sign>createpurse/wmid+createpurse/pursetype+reqn</sign>
    <createpurse>
        <wmid></wmid>
        <pursetype></pursetype>
        <desc></desc>
    </createpurse>
</w3s.request>

Request parameters:

name	purpose	comments
reqn	Request number	An integer, maximum 15 digits; This value must always be greater than the number of the previous request.
wmid	Signer's WMID	Is used only with WM Keeper WinPro authorization method
sign	Request signature	It takes the following parameters: createpurse/wmid+createpurse/pursetype+reqn Is used only with WM Keeper WinPro (Classic) authorization method
createpurse	Parameters of the created purse
createpurse\wmid	WMID of the purse	WM-identifier, which the created purse will belong to. Actually this WM-identifier must be the same as the identifier passed in the wmid tag of the identifier signing the request, as a purse can be created only for the identifier signing the request; it is impossible to work with the interface by trust.
createpurse\pursetype	Purse type	Type of the created purse as one Latin character in upper case B ,C ,D ,E ,G, Z, K, X, H, L, Y, F, T
createpurse\desc	Purse name	Text name of the purse, which will be displayed in the WebMoney Keeper WinPro or WebPro interface.

Response format:

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

Response parameters:

name	purpose	comments
reqn	Request number
retval	Execution code	0 - request successful, the interface returns the same error codes as Interface X2 does, except specific for this interface errors listed below
retdesc	Description of execution code
purse	parameters of the created purse	'id' attribute - unique purse number in the WebMoney system
purse\pursename	Purse number
purse\amount	Amount on the purse
purse\desc	Purse name

List of errors specific for the interface (retval):

code	description
15	Internal error of purse creation
31	There can be only one purse of the specified type
44	This WM-identifier was refused to create a purse of this type
48	It is not allowed to create a purse of this type for residents of your country
1007	Too many purses created for the WMID. Current limitation is 100 purses for a WMID.