WebMoney

Wiki

Interface WMC3

Interface WMC3. Query to receive processed a payments log (WebMoney.Check)

Recommended that you have carried out for Electronic Check Execution Control in the current settlement period. Log can be received for a period no longer than 3 months.

<w3s.request lang="" incoming="">
 <wmid></wmid>
 <sign type=""></sign>
 <datestart></datestart>
 <dateend></dateend>
 <wmtranid></wmtranid>
</w3s.request>
  • query parameters:
name reference comment
wmid WMID that signed a query used for authorization with the keys WM Keeper WinPro or by X.509 certificate WM Keeper WebPro
sign query signature formed out of: wmid + datestart + dateend + wmtranid
sign/@type query signature type 1 - signature formed using a special authentication module for keys WM Keeper WinPro, 2 - Signature formed using a X.509 certificate WM Keeper WebPro base64 encoded
datestart start date Time period (WMT time) has a format of YYYYMMDD HH:MM:SS, гwhere YYYY – year, MM – month, DD – date, HH – hours, mm – minutes, ss – seconds
dateend end date Time period (WMT time) has a format of YYYYMMDD HH:mm:ss, where YYYY – year, MM – month, DD – date, HH – hours, mm – minutes, ss – seconds
wmtranid - Optional parameter! WMT Transaction ID WMT unique operation ID
  • response format:
<w3s.response>
 <retval></retval>
 <retdesc></retdesc>
 <datestart></datestart>
 <dateend></dateend>
 <history cnt=""> 
  <payment id="" merchant="" status="" test="">
   <purse></purse>
   <phone></phone>
   <date></date>
   <point></point>
   <price></price>
   <amount></amount>
   <comiss></comiss>
   <wmtranid></wmtranid>
   <dateupd></dateupd>
   <rest></rest>
  </payment>
 </history> 
</w3s.response> 
  • response parameters:
name reference comment
retval Status or error code 0 - query successful. other codes show unsuccessful queries processing
retdesc error text description/empty error text description. random line from 0 to 255 symbols; encoding: win-1251
datestart start date Time period (WMT time) has a format of YYYYMMDD HH:MM:SS, where YYYY – year, MM – month, DD – date, HH – hours, mm – minutes, ss – seconds
dateend end date ime period (WMT time) has a format of YYYYMMDD HH:mm:ss, where YYYY – year, MM – month, DD – date, HH – hours, mm – minutes, ss – seconds
history/@cnt number of payments, received in return for a query number of payments, matching a query. Set up as a decimal figure, in double-quotes and contains not more than 18 digits
payment/@id unique transaction ID unique transaction ID formed by a Client in thier System. Set up as a decimal figure, double-quotes and contains not more than 18 digits. «id» uniqueness allows you to make a payment query when using the Electronic Cheque repeatedly with the same transaction ID and parameters, if a response did not arrive (e.g due to connection loss) or if the query was not processed. When repeating a query with the same number for the payment received earlier, the status of this payment will be returned.
payment/@merchant payment type determines payment type, "1" - towards the Seller.
payment/@status payment direction "check" - WebMoney check created, "purse" - added to a purse
payment/@test query mode determines query mode and has 2 values, "1"- payment in test mode, "0" - real payment.
payment/purse payment details of the RECIPIENT line – 13 symbols, first symbol latin letter Z or E and 12 digits no space between symbols allowed
payment/phone contact phone number of the RECIPIENT line – country code, operator code, phone number; no space between symbols and + sign allowed
payment/date payment date determines payment date and time in local time. Corresponds to the «payment date» field in the document, confirming Electronic Cheque use. Has a format of YYYYMMDD HH:mm:ss, where YYYY – year, MM – month, DD – date, HH – hours, mm – minutes, ss – seconds
payment/point unique ID of the Electronic Cheque point of use determines the unique identifier of the location where the Electronic Cheque was used. Set up as an integer, decimal number and contains not more than 16 digits. Corresponds to the «unique ID of the Electronic Cheque point of use» field in the document, confirming Electronic Cheque use
payment/price payment accepted in USD or EUR. Set up in @currency figure with a floating point (point - .(dot)) for ten and half can look as follows: 10.5; nonsignificant zeroes at the end and a point, if the figure is a counting number it should be omitted, e.g, 10.50 - wrong, 10.5 - correct, 9. - wrong, 9 - correct)
payment/amount top-up amount figure with a floating point (point - .(dot)) for ten and half can look as follows: 10.5; nonsignificant zeroes at the end and a point, if the figure is a counting number it should be omitted, e.g, 10.50 - wrong, 10.5 - correct, 9. - wrong, 9 - correct)
payment/comiss top-up commission figure with a floating point (point - .(dot)) for ten and half can look as follows: 10.5; nonsignificant zeroes at the end and a point, if the figure is a counting number it should be omitted, e.g, 10.50 - wrong, 10.5 - correct, 9. - wrong, 9 - correct)
payment/wmtranid WMT transaction ID unique WMT operation number
payment/dateupd date of operation "WebMoney time" Нas a format of YYYYMMDD HH:mm:ss, where YYYY – year, MM – month, DD – date, HH – hours, mm – minutes, ss – seconds
payment/rest Remaining balance returns remaining balance available for use. Set up as a decimal number with up to 2 decimal points (point - .(dot)). Next payment can be performed for an amount, not bigger than the returned remaining balance

See also:
XML-interfaces to top-up WMZ and WME
XML-interfaces