Wiki

Интерфейс ATM2

Интерфейс ATM2. Запрос на проведения платежа

Рекомендуется выполнять после успешного выполнения Предварительного запроса (Интерфейс ATM1). Если при выполнении этого запроса был получен отрицательный ответ, необходимо, после устранения причин повторить этот запрос с тем же номером уникальным id (во избежание двойного зачисления) до получения положительного ответа. Платеж считается принятым, если при выполнении запроса был получен положительный ответ <retval>0</retval>.

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

<w3s.request lang="">
 <wmid></wmid>
 <sign type=""></sign>
 <payment id="" currency="" test="" exchange="">
  <purse></purse>
  <price></price>
  <date></date>
  <point></point>
 </payment> 
</w3s.request>
  • параметры запроса:
название назначение примечание
lang язык сообщений используется для установки языка ответа. Допустимые значения: "en" - английский язык, "ru" - русский язык. При отсутствии атрибута, lang ="en"
wmid WMID подписавшего запрос используется при авторизации с ключами WM Keeper WinPro или сертификатом X.509 WM Keeper WebPro
sign подпись запроса формируется из параметров: wmid + id + currency + test + purse + price + date + point
sign/@type тип подписи запроса 1 - подпись сформирована с использованием специального модуля аутентификации для ключей WM Keeper WinPro, 2 - подпись сформирована с использованием сертификата X.509 WM Keeper WebPro в кодировке base64
payment/@id уникальный номер транзакции уникальный номер транзакции в системе Клиента, формируемый Клиентом. Задается целым десятичным числом, заключенным в двойные кавычки и содержит не более 18 цифр. уникальность «id» позволяет выполнять запрос на проведение платежа при реализации ЭЧП повторно с тем же номером транзакции и параметрами в случае не получения ответа на запрос (обрыв связи и т.д.) или неудачном прохождении запроса. При повторном запросе с этим же номером, для уже принятого платежа, будет возвращено состояние данного платежа.
payment/@currency валюта приема платежа определяет валюту приема платежа, "USD"- платеж принят в Долларах США, "EUR" - платеж принят в Евро, "RUB" - платеж принят в Рублях.
payment/@exchange валюта зачисление платежа параметр не обязательный и определяет валюту зачисления платежа, "USD"- Доллары США, "EUR" - Евро. При отсутствии соответствует валюте приема платежа
payment/@test режим запроса определяет режим запроса и имеет два значения, "1"- платеж проводится в тестовом режиме, "0" - платеж реальный.
payment/purse кошелёк ПОЛУЧАТЕЛЯ строка – 13 символов, первый символ латинская буква Z или E и 12 цифр; пробелы не допускаются
payment/price сумма принятая от плательщика в Евро или Долларах США. Задается в атрибуте @currency число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)
payment/date дата платежа определяет дату и время приема платежа по местному времени. соответствует значению поля «Дата платежа» на форме документа, подтверждающего реализацию ЭЧП. имеет формат YYYYMMDD HH:mm:ss, где YYYY – число года, MM – число месяца, DD – число дня, HH – часы, mm – минуты, ss – секунды
payment/point уникальный идентификатор точки реализации ЭЧП определяет уникальный идентификатор точки реализации ЭЧП. задается целым десятичным числом и содержит не более 16 цифр. соответствует значению поля «Уникальный идентификатор точки реализации ЭЧП» на форме документа, подтверждающего реализацию ЭЧП
  • формат ответа:
<w3s.response>
 <retval></retval>
 <retdesc></retdesc>
 <payment id="" currency="" test="">
  <purse></purse>
  <price></price>
  <amount></amount>
  <comiss></comiss>
  <rest></rest>
  <date></date>
  <point></point>
  <wmtranid></wmtranid>
  <dateupd></dateupd>
  <limit>
   <day></day>
   <month></month>
  </limit>
 </payment> 
</w3s.response>
  • параметры ответа:
название назначение примечание
retval код состояния или ошибки 0 - запрос выполнен успешно. другие значения кодов ответа говорят о неудачном прохождении запроса.
retdesc текстовое описание ошибки/пусто текст описания ошибки. произвольная строка от 0 до 255 символов; кодировка win-1251
payment/@id уникальный номер транзакции уникальный номер транзакции в системе Клиентом, формируемый Клиентом. Задается целым десятичным числом, заключенным в двойные кавычки и содержит не более 18 цифр. уникальность «id» позволяет выполнять запрос на проведение платежа при реализации ЭЧП повторно с тем же номером транзакции и параметрами в случае не получения ответа на запрос (обрыв связи и т.д.) или неудачном прохождении запроса. При повторном запросе с этим же номером, для уже принятого платежа, будет возвращено состояние данного платежа.
payment/@currency валюта платежа определяет валюту платежа, "USD"- платеж принят в Долларах США, "EUR" - платеж принят в Евро, "RUB" - платеж принят в Рублях.
payment/@test режим запроса определяет режим запроса и имеет два значения, "1"- платеж проводится в тестовом режиме, "0" - платеж реальный.
payment/purse кошелёк ПОЛУЧАТЕЛЯ строка – 13 символов, первый символ латинская буква Z или E и 12 цифр; пробелы не допускаются
payment/price сумма принятая от плательщика в Евро или Долларах США. Задается в атрибуте @currency число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)
payment/date дата платежа определяет дату и время приема платежа по местному времени. соответствует значению поля «Дата платежа» на форме документа, подтверждающего реализацию ЭЧП. имеет формат YYYYMMDD HH:mm:ss, где YYYY – число года, MM – число месяца, DD – число дня, HH – часы, mm – минуты, ss – секунды
payment/point уникальный идентификатор точки реализации ЭЧП определяет уникальный идентификатор точки реализации ЭЧП. задается целым десятичным числом и содержит не более 16 цифр. соответствует значению поля «Уникальный идентификатор точки реализации ЭЧП» на форме документа, подтверждающего реализацию ЭЧП
payment/amount сумма пополнения на кошелек число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)
payment/comiss комиссия пополнения число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)
payment/rest остаток средств обеспечения возвращает остаток средств обеспечения, возможных для реализации. Задается десятичным числом с точностью до второго знака (разделитель - .(точка) ). Следующая реализация платежа может быть выполнена на сумму, не превышающее возвращенное значение остатка
payment/wmtranid номер транзакции в системе WMT уникальный номер операции в системе WMT
payment/dateupd дата операции по "часам" WMT дату операции по "часам" WMT. имеет формат YYYYMMDD HH:mm:ss, где YYYY – число года, MM – число месяца, DD – число дня, HH – часы, mm – минуты, ss – секунды
payment/limit/day максимально возможная сумма реализации на кошелёк Пользователя в сутки число с плавающей точкой (разделитель - .(точка) )
payment/limit/month максимально возможная сумма реализации на кошелёк Пользователя в месяц число с плавающей точкой (разделитель - .(точка) )
  • код выполнения запроса:
код описание
-721 превышен лимит средств на кошелек получателя
-400 Перевод на кошелек не состоялся, т.к. операции перевода запрещены.
-401 Аттестат получателя по введенному кошельку не найден. Повторите запрос позже.
-402 Перевод на кошелек не состоялся, т.к. на кошельке недостаточно денег для выполнения операции.
-404 Перевод на кошелек не состоялся. Сетевой сбой.
-405 Перевод на кошелек не состоялся. Сетевой сбой.
-406 Перевод на кошелек не состоялся. Сетевой сбой.
-200 Платеж не выполнен, т.к указан ошибочный код государства паспорта.
-201 Платеж не выполнен, т.к указан ошибочный код государства паспорта.
-202 Платеж не выполнен, т.к указан ошибочный код государства паспорта.
-100 общая ошибка при разборе команды. неверный формат команды.
-101 Платеж не выполнен, т.к ФИО получателя отсутствует при указанных паспортных данных
-102 Платеж не выполнен, т.к ФИО получателя платежа должно совпадать с данными владельца кошелька.
-110 запросы отсылаются не с того IP адреса, который указан при регистрации данного интерфейса в Технической поддержке.
-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 не передан признак деноминации
-80 Владельцу кошелька WM идентификатора отказано в обслуживании.
-81 Оплата на кошелек отклонена из-за ограничений на прием платежей в адрес владельцу данного WM идентификатора
-53102 не выполнено условие постоянного увеличения значения параметра w3s.request/reqn
-53103 транзакция с таким значением поля w3s.request/trans/tranid уже выполнялась
-53110 нет доступа к интерфейсу
-53111 попытка перевода с кошелька не принадлежащего WMID, которым подписывается запрос; при этом доверие не установлено.
-534, -5315, -5319, -5323 внутренняя ошибка при создании транзакции
-535 идентификатор отправителя не найден
-536 корреспондент не найден
-537 кошелек получателя не найден
-5311 кошелек отправителя не найден
-5313 сумма транзакции должна быть больше нуля
-5317 недостаточно средств в кошельке для выполнения операции (исчерпан лимит, если происходит перевод с кошелька через механизм доверия)
-5318 указанная транзакция (wmtransid) не найдена, возникает, например, когда указанная к возврату и завершению операция с протекцией уже завершена или возвращена
-5320 указанный для завершения транзакции с протекцией код протекции неверен
-5321 счет, по которому совершается оплата не найден
-5322 по указанному счету оплата с протекцией не возможна
-5325 время действия оплачиваемого счета закончилось
-5326 в операции должны участвовать разные кошельки
-5329 типы кошельков отличаются
-5330 кошелек не поддерживает прямой перевод (например для кредитных кошельков C или D)
-5332, -5334 плательщику необходимо заполнить персональную информацию на сайте Центра Аттестации
-5335 плательщик не авторизован корреспондентом для выполнения данной операции
-5358 превышен лимит средств на кошельках получателя
-5372 Обслуживание на вывод средств в WME временно приостановлено, ознакомьтесь с требованиями Гаранта по идентификации
-5373, -5374 Обслуживание получателя средств в WME временно приостановлено, ознакомьтесь с требованиями Гаранта по идентификации
-5375 Код протекции должен иметь длину не меньше 5-ти символов

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