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 максимально возможная сумма реализации на кошелёк Пользователя в месяц число с плавающей точкой (разделитель - .(точка) )
  • код выполнения запроса:
код описание
-721 превышен лимит средств на кошелек получателя
-400 Перевод на кошелек не состоялся, т.к. операции перевода запрещены.
-401 Аттестат получателя по введенному кошельку не найден. Повторите запрос позже.
-402 Перевод на кошелек не состоялся, т.к. на кошельке недостаточно денег для выполнения операции.
-404 Перевод на кошелек не состоялся. Сетевой сбой.
-405 Перевод на кошелек не состоялся. Сетевой сбой.
-406 Перевод на кошелек не состоялся. Сетевой сбой.
-441 в запросе тег price указан ошибочный или не корректный
-467 в запросе не указана валюта конвертации
-200 Платеж не выполнен, т.к указан ошибочный код государства паспорта.
-201 Платеж не выполнен, т.к указан ошибочный код государства паспорта.
-202 Платеж не выполнен, т.к указан ошибочный код государства паспорта.
-100 общая ошибка при разборе команды. неверный формат команды.
-101 Платеж не выполнен, т.к ФИО получателя отсутствует при указанных паспортных данных
-102 Платеж не выполнен, т.к ФИО получателя платежа должно совпадать с данными владельца кошелька.
-110 запросы отсылаются не с того IP адреса, который указан при регистрации данного интерфейса в Технической поддержке.
-141 прямые пополнения кошельков продавцов запрещены
-1 Сумма платежа выше остатка на кошельке.
-2 Владелец кошелька не найден.
-3 Прием платежей на кошелек запрещен.
-4 Владельцу запрещен прием платежей.
-5 Владельцу кошелька в блек листе.
-6 неверное значение поля w3s.request/trans/amount
-7 неверное значение поля w3s.request/trans/desc
-8 слишком длинное поле w3s.request/trans/pcode
-9 поле w3s.request/trans/pcode не должно быть пустым если w3s.request/trans/period > 0
-10 поле w3s.request/trans/pcode должно быть пустым если w3s.request/trans/period = 0
-11 неверное значение поля w3s.request/trans/wminvid
-12 идентификатор переданный в поле w3s.request/wmid не зарегистрирован
-14 проверка подписи не прошла
-15 неверное значение поля w3s.request/wmid
-17 не передан признак деноминации
-41 в запросе тег price указан ошибочный или не корректный
-44 превышен лимит суммы разового платежа
-80 Владельцу кошелька WM идентификатора отказано в обслуживании.
-81 Оплата на кошелек отклонена из-за ограничений на прием платежей в адрес владельцу данного WM идентификатора
-85 в POST запросе отсутствует XML данные для исполнения платежа
102 не выполнено условие постоянного увеличения значения параметра w3s.request/reqn
103 транзакция с таким значением поля w3s.request/trans/tranid уже выполнялась
110 нет доступа к интерфейсу
111 попытка перевода с кошелька не принадлежащего WMID, которым подписывается запрос; при этом доверие не установлено.
4, 15, 19, 23 внутренняя ошибка при создании транзакции
5 идентификатор отправителя не найден
6 корреспондент не найден
7 кошелек получателя не найден
11 кошелек отправителя не найден
13 сумма транзакции должна быть больше нуля
17 недостаточно средств в кошельке для выполнения операции (исчерпан лимит, если происходит перевод с кошелька через механизм доверия)
18 указанная транзакция (wmtransid) не найдена, возникает, например, когда указанная к возврату и завершению операция с протекцией уже завершена или возвращена
20 указанный для завершения транзакции с протекцией код протекции неверен
21 счет, по которому совершается оплата не найден
22 по указанному счету оплата с протекцией не возможна
25 время действия оплачиваемого счета закончилось
26 в операции должны участвовать разные кошельки
29 типы кошельков отличаются
30 кошелек не поддерживает прямой перевод (например для кредитных кошельков C или D)
32, 34 плательщику необходимо заполнить персональную информацию на сайте Центра Аттестации
-5335, 35 плательщик не авторизован корреспондентом для выполнения данной операции
-5358, 58 превышен лимит средств на кошельках получателя
-5372, 72 Обслуживание на вывод средств в WME временно приостановлено, ознакомьтесь с требованиями Гаранта по идентификации
-5373, -5374, 73, 74 Обслуживание получателя средств в WME временно приостановлено, ознакомьтесь с требованиями Гаранта по идентификации
-5375,75 Код протекции должен иметь длину не меньше 5-ти символов
-5379 Обслуживание WMID получателя приостановлено в соответствии с п. 9.2. "Соглашения о трансфере имущественных прав цифровыми титульными знаками". Для возобновления обслуживания получатель должен связаться с арбитражным сервисом системы.
-5383 превышен лимит расходования средств с кошелька
-5385 превышена максимальная сумма разового платежа в адрес другого участника системы
-5386 превышен лимит входящих платежей на кошельках получателя
-5391 R-кошелек с указанным номером у получателя не найден. Однако у него есть P-кошелек с таким же номером. Пожалуйста, сделайте перевод на его P-кошелек.
-5393 Перевод WMR не идентифицированному участнику системы невозможен. Пожалуйста, попросите получателя средств указать информацию о себе на сайте https://passport.webmoney.ru
-5397 Отправитель перевода не акцептовал соглашение о смене гаранта по WME
-5398 Получатель перевода не акцептовал соглашение о смене гаранта по WME

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