Interface X23

Interface X23. Rejection of received invoices or cancellation of issued invoices.

The Keeper signing the requests should have a personal passport or higher

<w3s.request>
       <reqn></reqn>
       <wmid></wmid>
       <sign></sign>
       <invoicerefuse>
               <wmid></wmid>
               <wminvid></wminvid>
       </invoicerefuse>
</w3s.request>
  • Request properties:
Name Purpose Description
reqn Request number An integer, maximum 15 digits. Should always be larger than number of the previously submitted request!!! The maximum value 140737488355328
wmid Signer's WMID Is used only with the WM Keeper WinPro authorization method.
sign Request signature Formed from the following parameters: invoicerefuse/wmid+invoicerefuse/WMInvId+reqn Is used only with WM Keeper WinPro authorization method.
invoicerefuse Invoice attributes
invoicerefuse\wmid sender`s or receipt`s WMID
invoicerefuse\wminvid Invoice number the invoice's unique number in the WebMoney system; corresponds to id attribute of the parameter "invoice", response to the request on the Interface X1 (Sending invoice)
  • Response format:
<w3s.response>
       <reqn></reqn>
       <retval></retval>
       <retdesc></retdesc>
       <ininvoice id="n1" ts="n2">
                   <state>3</state>
                   <dateupd></dateupd>
       </ininvoice>
</w3s.response>
  • Response properties:
Name Purpose Description
reqn Request number  
retval Execution code Zero means that the request was executed successfully; see the execution code table for other values.
retdesc Execution code meaning  
ininvoice Invoice attributes the id attribute is the invoice's unique number in the WebMoney system. The ts attribute is an internal invoice number for the WebMoney system.
ininvoice\state Invoice state 0 - unpaid
1 - paid with protection
2 - fully paid or paid without protection
3 - rejected
ininvoice\dateupd Date and time of invoice status change YYYYMMDD HH:MM:SS
  • Execution codes
Code Description
-100 General parsing error. Incorrect request format.
-9 Invalid value in w3s.request/reqn field
-8 Invalid value in w3s.request/sign field
-1 Invalid value in w3s.request/invoice/orderid field
-2 Invalid value in w3s.request/invoice/customerwmid field
-11 Identifier sent in w3s.request/wmid is not registered
-12 Signature verification failed
102 Requirement for the steady increase of the w3s.request/reqn property was not followed
110 No permission for using the interface; certificate does not meet the requirements
111 attempt to reject invoice which issued not for WMID that sign the request, while the trust is not established. Or attempt to reject invoice which issued wmid not specified in parameter invoicerefuse\wmid.
6 Invoice recipient was not found
5,7 Invoice sender was not found
21 Invoice not found