Reader
This interface is only available to registered users. If you wish to register and obtain access for this interface please send the following information about your online project: the IP address from which requests will be sent and the URL of your website along with the purpose and stated use for the interface. Send all this information to WMID 941977853154 (technical support) via WM Keeper messenger. The Keeper signing the requests must have a personal passport (requests may take up to three working days to process).
<w3s.request>
<reqn></reqn>
<wmid></wmid>
<sign></sign>
<trans>
<tranid></tranid>
<pursesrc></pursesrc>
<pursedest></pursedest>
<amount></amount>
<period></period>
<pcode></pcode>
<desc></desc>
<wminvid></wminvid>
<onlyauth></onlyauth>
</trans>
</w3s.request>| Name | Purpose | Description |
| reqn | Request number | An integer, maximum 15 digits; Should always be greater than the number of the previously submitted request!!! |
| wmid | Signer’s WMID | Is used only with the WM Keeper Classic authorization method; |
| sign | Request signature | Contains the following parameters: reqn+tranid+pursesrc+pursedest+amount+period+pcode+desc+wminvid. Is used only with the WM Keeper Classic authorization method; |
| trans | Transaction parameters | |
| trans\tranid | Transaction number | Transaction number in the sender’s accounting system; an integer; it should be unique for each transaction (the same tranid may not be used for two transactions); |
| trans\pursesrc | Sender’s WM purse number | |
| trans\pursedest | Recipient’s purse number | |
| trans\amount | Amount of the sum transferred | A floating-point number, separated by a . (decimal point). Ten and a half, for example, is 10.5. Redundant zeros at the end, or decimal points if the number is a whole number, should not be used: 10.50 – invalid, 10.5 – valid, 9. – invalid, 9 – valid); |
| trans\period | Maximum protection period allowed in days; An integer in the range 0 – 255; 0 – means that no protection will be used; | |
| trans\pcode | Protection code | Arbitrary string of 0 to 255 characters. No spaces may be used at the beginning or the end; |
| trans\desc | Description of the purchased product or service | Arbitrary string of 0 to 255 characters. No spaces may be used at the beginning or the end; |
| trans\wminvid | Invoice number (in the WebMoney system) | An integer > 0; 0 means that the transfer is made without an invoice. Maximum is 2 32 -1; |
| trans\onlyauth | Consider recipient authorization | if 0 – the transfer will be made regardless of whether the recipient has authorized it; 1 – the transfer will be made only if the recipient allows the transfer (otherwise the refund code will be – 35) |
Important! trans\Amount (the sum being transferred) value may not be lower than the values specified in the table below:
| Type | Minimal allowed amount |
| WMZ | 0.01 |
| WME | 0.01 |
| WMR | 0.01 |
| WMU | 0.01 |
| WMY | 1000 |
| WMB | 2000 |
| WMG | 0.01 |
<w3s.response>
<reqn></reqn>
<retval></retval>
<retdesc></retdesc>
<operation id="n1" ts="n2">
<tranid></tranid>
<pursesrc></pursesrc>
<pursedest></pursedest>
<amount></amount>
<comiss></comiss>
<opertype></opertype>
<period></period>
<wminvid></wminvid>
<orderid></orderid>
<desc></desc>
<datecrt></dateupd>
<dateupd></dateupd>
</operation>
</w3s.response>| Name | Purpose | Description |
| reqn | Request number | |
| retval | Execution code | “0” means that the request was executed successfully. Check the execution code table for detailed information; |
| retdesc | Execution code description | |
| operation | Transaction parameters | id defines a unique invoice number in the WebMoney system; the ts attribute is an internal number for the invoice within the WebMoney system; |
| operation\tranid | Transaction number | Transaction number set in the sender’s accounting system; an integer; it should be unique for each transaction (the same tranid may not be used for two transactions); |
| operation\pursesrc | Sender’s WM purse number | |
| operation\pursedest | Recipient’s WM purse number | |
| operation\amount | Amount transferred | A floating-point number, separated by a . (decimal point). Ten and a half, for example, is 10.5. Redundant zeros at the end, or decimal points if the number is a whole number, should not be used: 10.50 – invalid, 10.5 – valid, 9. – invalid, 9 – valid); |
| operation\comiss | Fee charged | A floating-point number, separated by a . (decimal point). Ten and a half, for example, is 10.5. Redundant zeros at the end, or decimal points if the number is a whole number, should not be used: 10.50 – invalid, 10.5 – valid, 9. – invalid, 9 – valid); |
| operation\opertype | Transfer type | 0 – simple; 4 – code-protected; |
| operation\period | Protection period | An integer in the range 0 – 255; zero means that protection is disabled; |
| operation\wminvid | Invoice number (in the WebMoney system) | An integer > 0; 0 means that transfer is made without an invoice; |
| operation\orderid | Merchant’s invoice number | An integer > 0; 0 means that the transfer is made without an invoice; |
| operation\desc | Description of the purchased product or service | |
| operation\datecrt | Date and time of the transaction | |
| operation\dateupd | Date and time of the latest transaction status change |
| Code | Description |
| -100 | General parsing error. Incorrect request format. |
| -110 | Requests are sent from a different IP address than the one specified during the registration of the interface with technical support |
| -1 | Invalid value for w3s.request/reqn |
| -2 | Invalid value for w3s.request/sign |
| -3 | Invalid value for w3s.request/trans/tranid |
| -4 | Invalid value for w3s.request/trans/pursesrc |
| -5 | Invalid value for w3s.request/trans/pursedest |
| -6 | Invalid value for w3s.request/trans/amount |
| -7 | Invalid value for w3s.request/trans/desc |
| -8 | Field for w3s.request/trans/pcode is too long |
| -9 | Field w3s.request/trans/pcode should not be empty if w3s.request/trans/period > 0 |
| -10 | Field w3s.request/trans/pcode should be empty if w3s.request/trans/period = 0 |
| -11 | Invalid value for w3s.request/trans/wminvid |
| -12 | Identifier sent for w3s.request/wmid is not registered |
| -14 | Signature verification failed |
| -15 | Invalid value for w3s.request/wmid |
| 102 | The requirement for constant increase in the w3s.request/reqn parameter has not been met |
| 103 | A transaction with the submitted value for w3s.request/trans/tranid has already been executed |
| 110 | No access to interface |
| 111 | Attempt to transfer funds from a WM purse which does not belong to the WMID used to sign the request; Security trust has not been established. |
| 4, 15, 19, 23 | Internal error when creating transaction |
| 5 | Sender’s WMID not found |
| 6 | Correspondent not found |
| 7 | Recipient’s WM purse not found |
| 11 | Sender’s WM purse not found |
| 13 | Transaction amount should be >0 |
| 17 | Insufficient amount of funds in the purse |
| 21 | The invoice for this transaction was not found |
| 22 | Code-protected transfer for this invoice is not available |
| 25 | The invoice validity period has expired |
| 26 | Different purses should be used for this operation |
| 29 | The types of purses are different |
| 30 | Purse doesn’t support direct transfers |
| 35 | Payer is not authorized by the correspondent to execute this operation |
| 58 | Funds limit for the recipient’s purses has been exceeded |
Category: XML-Interfaces
This article in other languages: Русский