Reader
This interface is available only to registered users.
To register send via internal mail a message to WMID 941977853154 (technical support) containing some brief information about the project, website URL, IP address from which requests will be sent, the purpose and method for how the interface will be used. The Keeper signing the requests must have a personal passport (requests take up to three working days to process).
<w3s.request> <reqn></reqn> <wmid></wmid> <sign></sign> <testwmpurse> <wmid></wmid> <purse></purse> </testwmpurse> </w3s.request>
| name | purpose | comments |
| reqn | request number | an integer without delimiter, max number of digits is 15; the value must always be greater than the number of the previous request for transferring funds!!! |
| wmid | WMID of the user who signed the request | used only when authorizing WM Keeper Classic keys |
| sign | request signature is formed from the following: testwmpurse\wmid + testwmpurse\purse | used only when authorizing WM Keeper Classic keys |
| testwmpurse | request parameters | depending on the search, the user can specify both one or both parameters. possible combinations are given in the table below |
| testwmpurse\wmid | WM identifier | 12 digits |
| testwmpurse\purse | purse | the first character is one of the following: Z, R, E, U, B, G, C or D, followed by 12 digits |
<w3s.response> <reqn></reqn> <retval></retval> <retdesc></retdesc> <testwmpurse> <wmid available="-1" themselfcorrstate="-1" newattst="-1"> </wmid> <purse merchant_active_mode="-1" merchant_allow_cashier="-1"></purse> </testwmpurse> </w3s.response>
| name | purpose | comments |
| reqn | request number | |
| retval | request (search) execution code | 1 – search successful, 0 – no entries found |
| retdesc | description of request execution code | |
| testwmpurse | response parameters | possible values of the returned parameters are specified in the table below |
| testwmpurse\wmid | WM identifier which is being searched for | if the search is successful (the WM identifier exists), it is equal to the WM identifier in question. If not, then it will return an empty value. For all of these and the following attributes, “-1” means that the parameter’s state was not found. The available attribute, if “1”, means that ALL incoming operations (direct payments, invoice payments, merchant.webmoney payments, X2 interface payments) are forbidden for ALL purses for the WM identifier that has been searched for. The themselfcorrstate attribute is a decimal representation of whether the user for the WM identifier that is being searched for has allowed or forbidden the acceptance of payments, messages and invoices from NONcorrespondents. Payments are indicated by the fourth bit from the right, so the decimal value 0 (binary 0000) means that the user has not set any restrictions, while the value of 8 (binary 1000) means that the user has forbidden incoming payments to the user’s purses from NONcorrespondents. The newattst attribute is passport type for the WM identifier being searched for from the X11 interface. |
| testwmpurse\purse | the purse searched for | if the search is successful (the purse exists or belongs to the specified WM identifier), it is equal to the specified purse. For the merchant_active_mode attribute, “1” means that for the WM purse in question, payment acceptance through merchant.webmoney has been enabled. If the WM identifer also has a ban on incoming payments from NONcorresopndents in the themselfcorrstate attribute, then making direct payments (including through X2) to the purse is forbidden, and payments to this purse may be made only if the WM identifer has issued an invoice or through merchant.webmoney. For the merchant_allow_cashier attribute, “1” means that for the purse in question, payment acceptance through cash terminals to merchant.webmoney is enabled, and making direct payments to the purse (including through the X2 interface) is forbidden, and payments may be made to the purse only if the WMID has issued an invoice or through merchant.webmoney. |
Please note that if you are an X2 interface user, the attributes described above allow avoid payment attempts in advance in cases when the recipient of a payment is not expecting the payment (any direct payments which are not for an invoice or through merchant.webmoney). Most often this concerns merchants of goods and services for whom all incoming transactions are automated, and any direct payments which the merchant does not expect are categorically forbidden.
| search task | passed parameters | search result/ retval value |
returned parameters |
| search by identifier | wmid | found/1 | wmid |
| not found/0 | |||
| search by purse | purse | found/1 | wmid purse |
| not found/0 | purse | ||
| does the purse belong to the identifier | wmid purse |
the purse belongs to the identifier/1 | wmid purse |
| the purse does not belong to the identifier/1 | wmid | ||
| identifier is not registered/0 |
See also XML interfaces, How to check whether the specified WMID exists
Category: XML-Interfaces
This article in other languages: Русский