Interface X14. Fee-free refund.¶
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 (requests are processed up to three working days).
The interface allows the recepient of a regular payment to perform a fee-free refund between the same two purses within 30 days since the payment has been received. The interface supports work on trust for WM-identifiers for which the 'make transactions' option is active (in this case the 'wmid' tag may contain a trusted WMID, that differs from the recepient's WMID but has the permission to perform the request for a fee-free refund).
- Requests using WM Keeper WinPro (Classic) authorization should be sent to - https://w3s.webmoney.ru/asp/XMLTransMoneyback.asp
- Requests using WM Keeper WebPro (Light) certificate authorization should be sent to - https://w3s.wmtransfer.com/asp/XMLTransMoneybackCert.asp
- method - POST
- request format:
<w3s.request> <reqn></reqn> <wmid></wmid> <sign></sign> <trans> <inwmtranid></inwmtranid> <amount></amount> </trans> <wmb_denomination>1</wmb_denomination> </w3s.request>
- request parameters:
|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 WinPro (Classic) authorization|
|sign||the request signature||is formed as reqn+trans/inwmtranid+trans/amount, is used only with WM Keeper WinPro (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 sum of funds that should be refunded. It can't exceed the initial amount of incoming transaction: an error will occur in this case. If the refunding sum is less than the initial sum, then the interface can be called iteratively till the whole amount is returned to the sender. Attention!!! In case first refunding is partial (not the whole amount is returned), there is no duplication protection! For example: if the initial transaction amount is 300WM, only 50WM was refunded, and at the same time the response value (wmtransid) is unknown for some reason, there should NOT be an attempt to refund these 50 WM once more without getting evidence that the first transaction failed. The single verification implemented for partial refunding. It's impossible to make more than one refund of a transaction in half an hour - an error will occur. But on the expiry of this period the operation will be performed successfully, on condition that both amounts are less or equal the original one.|
|trans\moneybackphone||client phone number||If the customer made payment with a Paymer check, WebMoney card, WM-note or via e-invoicing system (Alpha-click, VTB, money transfer systems, THANK YOU from Sberbank bonus point etc. and the initial payment contains lmi_sdp_type) this field should contain the client's mobile phone number for a refund to the corresponding WM Check could be made.
Payments from WM Check service (usually it happens if a payment had been made by means of Web Merchant Interface which fact is verified by the presence of LMI_WMCHECK_NUMBER parameter in the "payment notification form") are refunded without phone number indication, for it is already known: a WM.Check identificator corresponds with the client's phone number.
Payments from Ukrainian terminals and banks performed by means of Web Merchant Interface (such transaction can be identified by the presence of LMI_SDP_TYPE=8 parameter in the "payment notification form" and by the fact the the sum had been transferred from the service purse U329791423310) are also refunded without client's phone number indication for it is already known. For payments made with credit cards and THANK YOU from Sberbank bonus point (lmi_sdp_type = 4 и = 7 correspondingly) there is no need to specify phone numbers as well , for it may be retrieved from the initial payment data.
|trans\capitallerpursesrc||capitaller purse||if the refund is made from a WMID that belongs to the Capitaller's passport, then this parameter should contain the number of the expenses purse that belongs to this capitaller, from which the refunds is to be made. If you don't, then the call of the interface will return an error, because it is impossible to perform a refund from the receipts purse to which the refunds was made.|
|wmb_denomination||the denomination flag||obligatorily! 1 – the transfer will be made only if the sender transmits the parameter|
- response format:
<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>
- response parameters:
|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||refund amount|
|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|
- interface-specific error codes (retval):
|17||Insufficient funds on the purse for refunding.|
|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 amount of inwmtranid transaction is less then the sum sent in the trans/amount request tag; a sum exceeding the initial one cannot be refunded.|
|53||more than 30 days elapsed since the 'inwmtranid' transaction date|
|54||If a payment had been made from a purse of PAYMER service, with a WM-card, WM-note or a paymer check, and moreover, moneybackphone parameter had not been specified in the request (that makes refunding impossible), the client's mobile phone number should be got and sent to moneybackphone, for a refund to the WM.Check account with the corresponding number could be made.|
|55||transaction performed via e-invoicing (lmi_sdp_type parameter in Result_URL) and no moneybackphone specified in the request (moreover, lmi_sdp_type indicates that the customer's phone number has never been received) and no refund can be performed. It is necessary to get the user's mobile phone number and put it to moneybackphone for a refund could be made to the WebMoney Check with the corresponding number.|
|56||the amount of inwmtranid transaction is less then the sum sent in the trans/amount request tag and less then the sums refunded for inwmtraind transactions earlier.|
|103||a transaction with such w3s.request/trans/inwmtranid value has already been performed and its sum totaled exactly the sum which should have been refunded.|
|104||a transaction with such w3s.request/trans/inwmtranid value and the same sum of partial refund has already been performed; it can be repeated not earlier than in half an hour.|
It is impossible to make a refund of transaction which was processed in test mode (LMI_MODE=1) via WebMoney merchant interface.
See also: XML-interfaces