WebMoney

Wiki

Интерфейс ATM3

Интерфейс ATM3. Запрос на получения курса валюты зачисление платежа

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

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

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

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