WebMoney

Wiki

Интерфейс A1

Интерфейс A1. Предварительный запрос на возможность проведения платежа

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

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

<w3s.request>
  <wmid></wmid>
  <sign type=""></sign>
  <payment>
   <pspname></pspname>
   <pspcode></pspcode>
   <pspnumber></pspnumber>
   <pspdate></pspdate>
   <purse></purse>
   <price></price>
  </payment>
</w3s.request>
* параметры запроса:
название назначение примечание
wmid WMID подписавшего запрос используется при авторизации с ключами WM Keeper WinPro или сертификатом X.509 WM Keeper WebPro
sign подпись запроса формируется из параметров: wmid+ pspname+ pspcode+ pspnumber+ pspdate+ purse+ price
sign/@type тип подписи запроса 1 - подпись сформирована с использованием специального модуля аутентификации для ключей WM Keeper WinPro 2 - подпись сформирована с использованием сертификата X.509 WM Keeper WebPro в кодировке base64
payment/pspname фамилия, имя и отчество ПОЛУЧАТЕЛЯ паспортные данные ПОЛУЧАТЕЛЯ (ФИО), пробелы в начале или конце не допускаются, кодировка win-1251
payment/pspcode код государства в паспорте ПОЛУЧАТЕЛЯ код государства ПОЛУЧАТЕЛЯ (Допустимые коды государств: ABH,AUS,AUT,AZE,ALB,AND,ARM,AFG,BLR,BEL,BGR,BIH,BRA,HUN,VEN,GTM,DEU,GRC,GEO,DNK,EGY,ISR,IND,IDN,FRA,
CZE,CHE,SWE,LKA,ECU,EST,JPN,IRL,ESP,ITA,ITL,YEM,KAZ,KHM,CAN,
KEN,CYP,KGZ,CHN,COL,CUB,LVA,LTU,MKD,MYS,MEX,MDA,MNG,NGA,NLD,NZL,NOR,ARE,PAK,PAN,POL,PRT,RUS,ROU,SAU,
SEN,SRB,SGP,SVK,GBR,SDN,TJK,THA,TWN,TKM,TUR,UZB,UKR,PHL,FIN),
пробелы в начале или конце не допускаются, кодировка win-1251.
payment/pspnumber серия и номер паспорта ПОЛУЧАТЕЛЯ паспортные данные ПОЛУЧАТЕЛЯ (СЕРИЯ(если существует), НОМЕР), знак N и пробелы не допускаются, кодировка win-1251
payment/pspdate дата выдачи паспорта ПОЛУЧАТЕЛЯ паспортные данные ПОЛУЧАТЕЛЯ (ДАТА ВЫДАЧИ), строка имеет формат YYYYMMDD, где YYYY – число года, MM – число месяца, DD – число дня
payment/purse кошелёк
ПОЛУЧАТЕЛЯ
"строка – 13 символов, первый символ латинская буква Z или E и 12 цифр; пробелы не допускаются"
payment/price сумма принятая от плательщика в Евро или Долларах США;"число с плавающей точкой (разделитель - .(точка) ) и для десяти с половиной может выглядеть так: 10.5 незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)"
  • формат ответа:
 
<w3s.response>
 <retval></retval>
 <retdesc></retdesc>
 <payment>
  <name></name>
  <pspcode></pspcode>
  <pspnumber></pspnumber>
  <pspdate></pspdate>
  <price></price>
  <purse></purse>
  <rest></rest>
  <limit>
   <day></day>
   <month></month>
  </limit>
 </payment>
</w3s.response> 
  • параметры ответа:
название назначение примечание
retval код состояния или ошибки 0 - запрос выполнен успешно
retdesc текстовое описание ошибки/пусто "произвольная строка от 0 до 255 символов, кодировка win-1251"
payment/pspname фамилия, имя и отчество ПОЛУЧАТЕЛЯ паспортные данные ПОЛУЧАТЕЛЯ (ФИО), пробелы в начале или конце не допускаются, кодировка win-1251
payment/pspcode код государства в паспорте ПОЛУЧАТЕЛЯ код государства ПОЛУЧАТЕЛЯ (Допустимые коды государств: ABH,AUS,AUT,AZE,ALB,AND,ARM,AFG,BLR,BEL,BGR,BIH,BRA,HUN,VEN,GTM,DEU,GRC,GEO,DNK,EGY,ISR,IND,IDN,FRA,
CZE,CHE,SWE,LKA,ECU,EST,JPN,IRL,ESP,ITA,ITL,YEM,KAZ,KHM,CAN,
KEN,CYP,KGZ,CHN,COL,CUB,LVA,LTU,MKD,MYS,MEX,MDA,MNG,NGA,NLD,NZL,NOR,ARE,PAK,PAN,POL,PRT,RUS,ROU,SAU,
SEN,SRB,SGP,SVK,GBR,SDN,TJK,THA,TWN,TKM,TUR,UZB,UKR,PHL,FIN),
пробелы в начале или конце не допускаются, кодировка win-1251.
payment/pspnumber серия и номер паспорта ПОЛУЧАТЕЛЯ паспортные данные ПОЛУЧАТЕЛЯ (СЕРИЯ(если существует), НОМЕР), знак N и пробелы не допускаются, кодировка win-1251
payment/pspdate дата выдачи паспорта ПОЛУЧАТЕЛЯ паспортные данные ПОЛУЧАТЕЛЯ (ДАТА ВЫДАЧИ), строка имеет формат YYYYMMDD, где YYYY – число года, MM – число месяца, DD – число дня
payment/purse кошелёк ПОЛУЧАТЕЛЯ "строка – 13 символов, первый символ латинская буква Z или E и 12 цифр, пробелы не допускаются"
payment/price сумма принятая от плательщика в Евро или Долларах США "число с плавающей точкой (разделитель - .(точка) ) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)"
payment/rest остаток средств обеспечения возвращает остаток средств обеспечения, возможных для реализации. Задается десятичным числом с точностью до второго знака (разделитель - .(точка) ). Следующая реализация платежа может быть выполнена на сумму, не превышающее возвращенное значение остатка
payment/limit/day максимально возможная сумма реализации на кошелёк Пользователя в сутки число с плавающей точкой (разделитель - .(точка) )
payment/limit/month максимально возможная сумма реализации на кошелёк Пользователя в месяц число с плавающей точкой (разделитель - .(точка) )
  • код выполнения запроса:
код описание
-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 идентификатора
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 плательщику необходимо заполнить персональную информацию на сайте Центра Аттестации
35 плательщик не авторизован корреспондентом для выполнения данной операции
58 превышен лимит средств на кошельках получателя
72 Обслуживание на вывод средств в WME временно приостановлено, ознакомьтесь с требованиями Гаранта по идентификации
73, 74 Обслуживание получателя средств в WME временно приостановлено, ознакомьтесь с требованиями Гаранта по идентификации
75 Код протекции должен иметь длину не меньше 5-ти символов

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