WebMoney

Wiki

Интерфейс ATM1

Интерфейс ATM1. Предварительный запрос на возможность проведения платежа

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

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

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

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