Interface X16. Creating a purse.¶
This interface is available only to registered clients. To register send via internal mail a message to "WMID 941977853154":wmk:msgto?to=941977853154&subject= (Technical support) containing short information about your project, URL of your web-site, IP address from which requests will be sent, purpose and method to be used for the interface. The Keeper signing the requests must have personal passport (requests can be processed up to 3 working days).
This interface allows creating a new purse with the specified name and type.
<w3s.request>
<reqn></reqn>
<wmid></wmid>
<sign>createpurse/wmid+createpurse/pursetype+reqn</sign>
<createpurse>
<wmid></wmid>
<pursetype></pursetype>
<desc></desc>
</createpurse>
</w3s.request>
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 ,R ,U ,Y ,Z. |
createpurse\desc |
Purse name |
Text name of the purse, which will be displayed in the Webmoney Keeper WinPro or Light interface. |
<w3s.response>
<reqn></reqn>
<retval></retval>
<retdesc></retdesc>
<purse id="n">
<pursename></pursename>
<amount></amount>
<desc></desc>
</purse>
</w3s.response>
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. |
See also XML-interfaces