WebMoney

Wiki

Interface X14

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).

<w3s.request>
    <reqn></reqn>
    <wmid></wmid>
    <sign></sign>
        <trans>
            <inwmtranid></inwmtranid>
            <amount></amount>
        </trans>
<wmb_denomination>1</wmb_denomination>
</w3s.request>
  • request parameters:
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 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:
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 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):
code description
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/tranid 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/tranid 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.

The members who accept payments via Web Merchant Interface can call this iterface manually on the transaction verification page

See also: XML-interfaces