| Правильная ссылка на эту статью: |
Интерфейс ATM5
Предварительный запрос на возможность проведения платежа с получением информации о принадлежности кошелька¶
Рекомендуется выполнять до приема денежных средств от ПОЛУЧАТЕЛЯ. При выполнении этого запроса контролируются исправность технических средств (наличие связи, работоспособность и т.д.), обеспеченность средствами для реализации.
Юридическое лицо, использующее согласно договору средства аутентификации WMID, подписывающее запрос должно иметь подписанный договор с уполномоченным представителем системы WebMoney Transfer.
Для того, чтобы ответ содержал информацию о WMID владельца кошелька, необходимо дополнительное согласование с уполномоченным представителем системы WebMoney Transfer (менеджером).
- URL для передачи — https://transfer.gdcert.com/ATM/Xml/PrePayment3.ashx
- метод – POST
- формат запроса:
<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 agentid="" currency="" exchange="" merchant="" wmid="" status=""> <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/@agentid | номер договора | задается целым десятичным числом и содержит не более 6 цифр |
| payment/@currency | валюта приема платежа | определяет валюту приема платежа, "USD"- платеж принят в Долларах США, "EUR" - платеж принят в Евро, "RUB" - платеж принят в Рублях . |
| payment/@exchange | валюта зачисление платежа | параметр не обязательный и определяет валюту зачисления платежа, "USD"- Доллары США, ""EUR"" - Евро. При отсутствии соответствует валюте приема платежа |
| payment/@merchant | принадлежность кошелька | задается целым числом. 1 - кошелек получателя принадлежит мерчанту |
| payment/@wmid | wmid получателя платежа | строка – 12 символов, выдается только при условия согласования с менеджером |
| payment/@status | вид зачисления | строка, purse - кошелек, check - вм чек |
| 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 | максимально возможная сумма реализации на кошелёк Пользователя в месяц | число с плавающей точкой (разделитель - .(точка) ) |
- код выполнения запроса:
| код | описание |
| -881 | Пополнение кошелька запрещено. Обслуживание Wmid приостановлено (ограничение на приход) |
| -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