WebMoney

Wiki

Интерфейс WMC1

Интерфейс WMC1. Предварительный запрос на возможность проведения платежа (WebMoney.Check)

Рекомендуется выполнять до приема денежных средств от ПОЛУЧАТЕЛЯ. При выполнении этого запроса контролируются исправность технических средств (наличие связи, работоспособность и т.д.), обеспеченность средствами для реализации. Также осуществляется проверка на возможность выпуска WebMoney.Check.

Юридическое лицо, использующее согласно договору средства аутентификации WMID, подписывающее запрос должно иметь подписанный договор с уполномоченным представителем системы WebMoney Transfer.

<w3s.request lang="en">
 <wmid></wmid>
 <sign type=""></sign>
 <payment currency="">
  <purse></purse>
  <phone></phone>
  <price></price> 
 </payment> 
</w3s.request>
  • параметры запроса:
название назначение примечание
lang язык сообщений используется для установки языка ответа. Допустимые значения: "en" - английский язык, "ru" - русский язык. При отсутствии атрибута, lang ="en"
wmid WMID подписавшего запрос используется при авторизации с ключами WM Keeper WinPro или сертификатом X.509 WM Keeper WebPro
sign подпись запроса формируется из параметров: wmid + currency + purse + phone + price
sign/@type тип подписи запроса 1 - подпись сформирована с использованием специального модуля аутентификации для ключей WM Keeper WinPro; 2 - подпись сформирована с использованием сертификата X.509 WM Keeper WebPro в кодировке base64
payment/@currency валюта платежа определяет валюту платежа, "USD"- платеж принят в Долларах США, "EUR" - платеж принят в Евро.
payment/purse кошелёк ПОЛУЧАТЕЛЯ (необязательный параметр при указании тега payment/phone) строка – 13 символов, первый символ латинская буква Z или E и 12 цифр, пробелы не допускаются
payment/phone контактный мобильный телефон ПОЛУЧАТЕЛЯ (необязательный параметр при указании тега payment/purse) строка – код страны, код оператора, номер телефона, пробелы и знак + не допускаются
payment/price сумма принятая от плательщика в Евро или Долларах США. Задается в атрибуте @currency число с плавающей точкой (разделитель - . (точка)) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)
  • формат ответа:
<w3s.response>
 <retval></retval>
 <retdesc></retdesc>
 <payment currency="" merchant="" status="">
  <purse></purse>
  <phone></phone>
  <price></price>
  <amount></amount>
  <limit></limit>
 </payment> 
</w3s.response>
  • параметры ответа:
название назначение примечание
retval код состояния или ошибки 0 - запрос выполнен успешно. другие значения кодов ответа говорят о неудачном прохождении запроса.
retdesc текстовое описание ошибки/пусто "текст описания ошибки. произвольная строка от 0 до 255 символов; кодировка win-1251"
payment/@currency валюта платежа определяет валюту платежа, "USD"- платеж принят в Долларах США, "EUR" - платеж принят в Евро.
payment/@merchant принадлежность получателя определяет принадлежность получателя, "0"- зачисление не в адрес продавца, "1" - зачисление в адрес продавца.
payment/@status направление зачисления определяет куда будет зачислен платеж, "purse"- зачисление на кошелек, "1" - выпуск WebMoney чека.
payment/purse кошелёк ПОЛУЧАТЕЛЯ "строка – 13 символов, первый символ латинская буква Z или E и 12 цифр; пробелы не допускаются"
payment/phone контактный мобильный телефон ПОЛУЧАТЕЛЯ строка – код страны, код оператора, номер телефона; пробелы и знак + не допускаются
payment/price сумма принятая от плательщика в Евро или Долларах США. Задается в атрибуте @currency число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)
payment/amount сумма, которая зачислится плательщику в WMZ или WME на кошелек или номинал выпуска WebMoney чека число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)
payment/limit максимально возможная сумма реализации на кошелёк Пользовател число с плавающей точкой (разделитель - .(точка))

См. также
XML-интерфейсы зачисления WMZ и WME