Reader
This interface is available only to registered clients. If you are a Merchant passport holder and use merchant.webmoney.ru then you can perform refunds from an active merchant purse without an additional registration. Otherwise please send information on your online project, your IP and URL of your website, and purpose for use of this interface to WM-ID 941977853154 (technical support) via WM Keeper messenger. In addition, you have to receive a personal WM passport.
This interface allows a recipient of any sum of funds to send the same amount of funds back to the same payer’s purse from the same payee’s purse during 14 days.
<w3s.request> <reqn></reqn> <wmid></wmid> <sign></sign> <trans> <inwmtranid></inwmtranid> <amount></amount> </trans> </w3s.request>
| name | purpose | description |
| reqn | request number | an unsigned integer, maximum 15 digits; must always be greater than the previous request number |
| wmid | the signer WMID | is used only with WM Keeper Classic authorization |
| sign | the request signature | is formed as reqn+trans/inwmtranid+trans/amount, is used only with WM Keeper Classic authorization |
| trans | the refund transaction parameters | |
| trans\inwmtranid | the transaction id | this tag contains the internal WebMoney id (positive integer) of the transaction (wmtranid) to be refunded. The transaction type must be – simple (opertype=0) |
| trans\amount | the transaction amount | this tag contains the transaction amount, this field is used only for a check and it should match the sum provided in the corresponding tag of the inwmtranid transaction. If these sums doesn’t match the corresponding error code will be returned (see below) |
<w3s.response> <reqn></reqn> <retval></retval> <retdesc></retdesc> <operation id="n1" ts="n2"> <inwmtranid></inwmtranid> <pursesrc></pursesrc> <pursedest></pursedest> <amount></amount> <comiss></comiss> <desc></desc> <datecrt></dateupd> <dateupd></dateupd> </operation> </w3s.response>
| name | purpose | description |
| reqn | the request number | |
| retval | the return value | 0 – the request is successfully processed, this interfcae returns the same error codes as the Interface X2, except the interface-specific errors listed below |
| retdesc | return value description | |
| operation | transaction attributes | id defines a unique number of a transaction in the WebMoney System ts defines a service number of a transaction in the WebMoney System |
| operation\inwmtranid | refund transaction number | |
| operation\pursesrc | purse number | the purse, from which the refund has been performed. It is the payee’s purse, which received inwtranid transaction |
| operation\pursdest | номер кошелька | the purse, to which the refund has been performed. It is the payee’s purse, which sent the inwtranid transaction |
| operation\amount | refund amount | this sums matches the sum of the inwmtranid transaction |
| operation\comiss | refund fee | = 0 |
| operation\desc | refund description | has the format “Moneyback transaction WMTranId: InWMTranID. (inwmtranid_desc)”, where inwmtranid_desc is the original description of the inwmtranid transaction. |
| operation\datecrt | date and time of the operation | |
| operation\dateupd | date and time of the last modification of the operation |
| code | description |
| 50 | the transaction ‘inwmtranid’ is not found, may be this transaction was performed more than one month ago or it is a transation between credit purses |
| 51 | the transaction ‘inwmtranid’ is the protected one (complete or incomplete), it cannot be refunded by this interface |
| 52 | the transaction ‘inwmtranid’ sum doesn’t match the sum specified in ‘trans/amount’ request tag |
| 53 | more than 14 days elapsed since the ‘inwmtranid’ transaction date |
| 103 | this value of ‘w3s.request/trans/tranid’ has already been used |
Category: XML-Interfaces
This article in other languages: Русский