WebMoney

Wiki

Interface WMC2

INTERFACE WMC2. Payment request (WebMoney.Check)

We recommend sending this request after the Preliminary request has been successfully fulfilled (Interface WMC1). If you receive at negative response for this request you should send it again (after the cause is eliminated) with the same unique id number (to avoid the double crediting of funds) until you receive at positive response. The payment is considered to be made following the receipt of a positive response <retval>0</retval>.

The signatory WMID should have the Agency Agreement signed with Leadant Solutions Ltd.

<w3s.request>
 <wmid></wmid>
 <sign type=""></sign>
 <payment id="" currency="" test="">
  <purse></purse>
  <phone></phone>
  <price></price>
  <date></date>
  <point></point>
 </payment> 
</w3s.request>
  • query parameters:
title purpose note
wmid WMID of the signatory Used for the authorization via WM Keeper WinPro keys or X.509 WM Keeper WebPro certificate
sign The request signature Formed by the parameters: wmid+ pspname+ pspcode+ pspnumber+ pspdate+ purse+ price
sign/@type Type of the request signature 1 – the signature is formed by the special authentication module for WM Keeper WinPro keys, 2 – the signature is formed by X.509 WM Keeper WebPro certificate, encoding base64
payment/@id Unique transaction ID number Unique transaction ID number formed by the Customer. A decimal number in double quotes that contains no more than 18 digits. The uniqueness of the «id» allows you to resend the payment request with the same transaction number in case there are no response to the previous request (connection error, etc.) or if the request has failed. In case of the repeated request with the same number for the payment that is already received, the payment status will be retrieved
payment/@currency Payment currency Specifies the payment currency, "USD"- payment in US dollars, "EUR" – payment in Euro.
payment/@test Request mode Specifies the request mode and has two values, "1"- payment in the test mode, "0" – operation mode.
payment/purse Payment details of the RECIPIENT 13 symbols, the first symbol is the Latin letter Z or E and 12 digits; no gaps
payment/phone Mobile phone number of the RECIPIENT Optional parameter Country code, operator code, phone number; no gaps and “+” sign
payment/price The amount in Euro or USD received from the payer Specified in the attribute @currency Floating-point number (delimiter - .(point)) for ten and a half should look like: 10.5; nonsignificant zeroes at the end and after the point are not required for the whole number, e.g., 10.50 - wrong, 10.5 - correct, 9. - wrong, 9 - correct)
payment/date Payment date Specifies the date and time of the payment, local time. Corresponds to the «Payment date» on the code confirmation. YYYYMMDD HH:mm:ss, where YYYY – the year, MM – the month, DD – the day, HH – hours, mm – minutes, ss – seconds
payment/point Unique number issued by the Agent A whole decimal number that contains no more than 16 digits. Corresponds to the «Unique number» on the code confirmation.
  • response format:
<w3s.response>
 <retval></retval>
 <retdesc></retdesc> 
 <payment id="" currency="" test="">
  <purse></purse>
  <phone></phone>
  <price></price>
  <amount></amount>
  <comiss></comiss>
  <rest></rest>
  <date></date>
  <point></point>
  <wmtranid></wmtranid>
  <dateupd></dateupd>
 </payment> 
</w3s.response>
  • response parameters:
title purpose note
retval Error code or status code 0 – request is successfully completed
retdesc Text description of the error/empty "Random line from 0 to 255 symbols; encoding win-1251"
payment/@id Unique transaction ID number Unique transaction ID number formed by the Customer. A decimal number in double quotes that contains no more than 18 digits. The uniqueness of the «id» allows you to resend payment request with the same transaction number in case there are no response to the previous request (connection error, etc.) or if the request has failed. In case of the repeated request with the same number for the payment that is already received, the payment status will be retrieved
payment/@currency Payment currency Specifies the payment currency, "USD"- payment in US dollars, "EUR" – payment in Euro.
payment/@test Request mode Specifies the request mode and has two values, "1"- payment in the test mode, "0" – operation mode.
payment/purse Payment details of the RECIPIENT 13 symbols, the first symbol is the Latin letter Z or E and 12 digits; no gaps
payment/phone Mobile phone number of the RECIPIENT Optional parameter Country code, operator code, phone number; no gaps and “+” sign
payment/price The amount in Euro or USD received from the payer Specified in the attribute @currency Floating-point number (delimiter - .(point)) for ten and a half should look like: 10.5; nonsignificant zeroes at the end and after the point are not required for the whole number, e.g., 10.50 - wrong, 10.5 - correct, 9. - wrong, 9 - correct)
payment/date Payment date Specifies the date and time of the payment, local time. Corresponds to the «Payment date» on the code confirmation. YYYYMMDD HH:mm:ss, where YYYY – the year, MM – the month, DD – the day, HH – hours, mm – minutes, ss – seconds
payment/point Unique number issued by the Agent A whole decimal number that contains no more than 16 digits. Corresponds to the «Unique number» on the code confirmation.
payment/amount Replenishment amount Floating-point number (delimiter - .(point)) for ten and a half should look like: 10.5; nonsignificant zeroes at the end and after the point are not required for the whole number, e.g., 10.50 - wrong, 10.5 - correct, 9. - wrong, 9 - correct)
payment/comiss Commission Floating-point number (delimiter - .(point)) for ten and a half should look like: 10.5; nonsignificant zeroes at the end and after the point are not required for the whole number, e.g., 10.50 - wrong, 10.5 - correct, 9. - wrong, 9 - correct)
payment/rest balance Shows the available balance. A decimal number rounded to two places after decimals (the delimiter. - (Point)). The next payment amount can not exceed the balance.
payment/wmtranid Transaction number in WMT system Unique transaction number in the WebMoney Transfer System
payment/dateupd Transaction date, WMT time YYYYMMDD HH:mm:ss, where YYYY – the year, MM – the month, DD – the day, HH – hours, mm – minutes, ss – seconds

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