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