Wiki

Exchanger Trans Union

There is XML-API implemented in the section for combining two new bids .

<?xml version=\"1.0\"?>
<wm.exchanger.request>
    <wmid></wmid>
    <signstr></signstr>
    <operid></operid>
    <unionoperid></unionoperid>
    <capitallerwmid></capitallerwmid>
</wm.exchanger.request>
  • Request parameters:
name purpose comments
wmid Signer's WMID WMID from which a new bid will be placed.
signstr Request signature. 132-digits digital signature (by .kwm keys of the wmid) encoding the value of three tags of the request, pulled together in one line without spaces, "wmid + operid + unionoperid"
operid number of a new bid placed by WMID to which it is necessary to join bid unionoperid
unionoperid the number of a new bid placed by WMID which is necessary to join with operid bid and in this case both amounts for exchange will be joined and the rate of operid bid will remain the same
capitallerwmid optional field if Capitaller’s WMID is being transferred in this field (www.capitaller.ru) the exchange bid on behalf of capitallerwmid may be set under this request. In this case there must be an access for WMID which signs the request which is described at Capitaller’s Impersonalization page.
  • Response format:
<?xml version=\"1.0\"?>
<wm.exchanger.response>
    <retval></retval>
    <retdesc></retdesc>
</wm.exchanger.response>
  • Response parameters
Name Purpose Description
retval Execution code "0" means that the request was executed successfully. Check the execution code table for detailed information
retdesc Execution code description error description in case retval tag is not 0
capitallerwmid
  • Example
<?xml version=\"1.0\"?>
<wm.exchanger.request>
    <wmid>500000000008</wmid>
    <signstr>
        7bdb9ae64f5c0d568566a198b8c46c4be181085e898c4fafa1033968bb2762c96444c01db68b6ecc2d8ed0a312d1c5091907a8ba59d11854cc7f9560426bd060019b
    </signstr>
    <operid>27761393</operid>
    <unionoperid>27795291</unionoperid>
    <capitallerwmid>0</capitallerwmid>
</wm.exchanger.request>

<?xml version=\"1.0\"?>
<wm.exchanger.response>
    <retval>0</retval>
    <retdesc></retdesc>
</wm.exchanger.response>
  • Execution/Error Codes
Code Description
-10 The client wmid is not specified
-11 Error occurred during the signature verification, tag signstr
-12 Error when specifying the bid number which needs to be changed
-13 Error when specifying a new bid rate. It should contain only digits and a delimiter symbol with no spaces or unnecessary symbols.It must be specified and maximum length is 10 symbols
-14 Signature verification failed.%Str%
-15 Error - Failed loading XML with query parameters
1 Attachable bid &unionoperid& is not found in the list of your new bids.
2 Attachable bid &unionoperid& has been deleted or has not been paid yet for or the exchange for it is fully completed, it can not be attached to other bids
3 The main bid &operid& is not found in the list of your new bids
4 The connection is not made,please try again and if it does not work, contact your Administrator
14 It is not allowed to combine the bid with itself
15 The exchange directions (type of the incoming WM-currency) of the main and attached bid must be the same
16 The attached bid is deleted, or the exchange is complete, it can not be attached to other bid
17 The main bid &operid& is removed, or exchange it completely finished, it is impossible to attach other bids to that one
19 The main bid &operid& is an exchange now, it is impossible to attach other bid. Please try again in a few minutes
20 The attached bid &unionoperid& is in exchange now, it can not be attached to other bids.Please try again in a few minutes
21 You are trying to attach a bid &unionoperid& that is already attached, view your list of new bids to clarify the current status of each bid
41 Result return error, try again
51 Error occurred (database level), descrition:
128 Error occurred (unknown)
190 The signer WMID has no rights to this bid which belongs to the WMID Capitaller.
193 The signer WMID has no rights to this bid which belongs to the WMID Capitaller.