| Permalink: |
Interface X2
Interface X2. Transferring funds from one purse to another.¶
This interface is available for registered members only and can be used for making transfers from purses of any WM Keeper, including Budget Automates.
The option can be enabled at the Web Merchant Interface service settings page in the "additional parameters" section. Enabling this option you undertake to use the "trans\onlyauth = 1" parameter. The Keeper that signs requests should have Personal passport.
To avoid paying the fee while testing X2 we recommend that you use purses of the same type belonging to one WMID, or purses of the same type belonging to one Passport.
- Requests using WM Keeper WinPro authorization should be sent to: https://w3s.web.money/asp/XMLTrans.asp
- Requests using WM Keeper WebPro authorization should be sent to: https://w3s.wmtransfer.com/asp/XMLTransCert.asp
- Method: POST
- Request format:
<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>
- Request parameters
| Name | Purpose | Description |
| reqn | Request number | An integer, maximum 18 digits. must be greater than a previous payment request number!!! Max value is 999999999999999999 Each WMID that signs the request is linked to its` unique sequence of monotonically increasing values of this parameter. |
| wmid | Signer's WMID | Is used only with the WM Keeper WinPro 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 WinPro authorization method; |
| trans | Transaction parameters | |
| trans\tranid | Transaction number | transaction number in the sender's accounting system; any positive integer(must be less than 9007199254740992); must be unique for the WMID that signs the request. It's not allowed to perform two transactions with the same 'tranid' from one WMID (from different purses of a WMID either). The uniqueness of tranid value is verified for the period not shorter than one year. |
| 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 | Protection period | Maximum protection period allowed in days; An integer in the range 0 - 120; 0 - means that no protection will be used; |
| trans\pcode | Protected payment | Arbitrary string of 5 to 255 characters. No spaces may be used at the beginning or the end or or an empty string for time protection |
| 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 | obligatorily! 1 – the transfer will be made only if the recipient allows the transfer (otherwise the returned code will be - 35). The recepient can prohibit accepting payments in two cases. The first is when the sender is an authorized correspondent for the recepient for whom the latter had prohibited the possibility of making payments to his purses ('restrictions' section in the correspondent's properties). The second is when the sender isn't an authorized correspondent for the recepient, and the latter had prohibited the possibility of making payments to his purses for all unauthorized members. |
Important! trans\Amount (the sum being transferred) value may not be lower than 0.01.
- Response format
<w3s.response>
<reqn></reqn>
<retval></retval>
<retdesc>0</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>
- Response parameters
| 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 |
- Execution/Error Codes
| Code | Description |
| -100 | General parsing error. Incorrect request format. |
| -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 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 |
| -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. the option can be enabled at the Web Merchant Interface service settings page in the "additional parameters" section. |
| 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 |
| 18 | the specified transaction (wmtransid) was not found, this occurs when the protected payment which intended to be returned or completed has already been returned or completed |
| 20 | the protection code specified to complete a protected payment is incorrect |
| 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 |
| 32, 34 | Payer must inform their personal information on the web-site WebMoney Passport |
| 35 | Payer is not authorized by the correspondent to execute this operation |
| 46 | transfer of funds will only become possible after obtaining a certificate not lower than formal and meeting other requirements of the Guarantor. You can check the compliance of your WMID with these requirements on the page https://wiki.wmtransfer.com/projects/webmoney/wiki/Requirements_for_WMB_Purse_owners_(Natural_Persons) |
| 58, 92 | Funds limit for the recipient’s purses has been exceeded |
| 62 | the payer must indicate and verify the mobile phone in his passport at https://passport.wmtransfer.com/asp/MobileVer.asp |
| 64 | transfer of funds will become possible after specifying the email on the page https://passport.wmtransfer.com/asp/EmailEdit.asp |
| 66, 206, 306 | Service of the sender's WMID has been suspended in accordance with clause 9.2. "Digital Title Unit Transfer Agreements". To resume service, the sender must contact the system's arbitration service. |
| 72? 1072 | Servicing of WME or WMK withdrawals temporarily suspended. Please read the WME guarantor identification rules or the WMK guarantor identification rules |
| 73, 74 | Service to the WME or WMK funds recipient has been temporarily suspended. Please read the WME guarantor identification rules or the WMK guarantor identification rules |
| 75 | The protection code must be at least five characters long |
| 79, 207, 307 | Service of the recipient's WMID has been suspended in accordance with clause 9.2. "Digital Title Unit Transfer Agreements". To resume service, the sender must contact the system's arbitration service. |
| 83 | The purse spending limit exceeded |
| 85, 113 | The maximum amount of payment to another member of the system has been exceeded |
| 86 | Ingoing payment limits are exceeded on the recipient's purse |
| 97 | Service to your WME purse has been suspended. A change of WME Guarantor is in process, you can use your WME purse again from 25-07-2022. Should you have any questions, please contact us at support@webmoney.eu |
| 98 | The recepient of the payment hasn't accepted the agreement on the change of the WME Guarantor |
| 99 | The service of your K-purses has been suspended. Please accept the new terms and conditions of the WMK Guarantor on the following page to resume the service. |
| 100 | The service of WMK recipient has been temporarily suspended. |
| 107 | The spending limit has been exceeded. You should increase the level of identification or perform the operation later. For more details see Requirements for WM Purse owners (Natural Persons) |
| 112 | The amount of the operation must be at least the minimum allowed |
| 197 | You have not accepted the Terms and Conditions of the new WME Guarantor! Click the Accept and Give Consent to accept the new WME Guarantor Terms and Conditions |