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 максимально возможная сумма реализации на кошелёк Пользователя в месяц число с плавающей точкой (разделитель - .(точка) )
  • код выполнения запроса:
код описание
-721 превышен лимит средств на кошелек получателя
-400 Перевод на кошелек не состоялся, т.к. операции перевода запрещены.
-401 Аттестат получателя по введенному кошельку не найден. Повторите запрос позже.
-402 Перевод на кошелек не состоялся, т.к. на кошельке недостаточно денег для выполнения операции.
-404 Перевод на кошелек не состоялся. Сетевой сбой.
-405 Перевод на кошелек не состоялся. Сетевой сбой.
-406 Перевод на кошелек не состоялся. Сетевой сбой.
-441 в запросе тег price указан ошибочный или не корректный
-467 в запросе не указана валюта конвертации
-200 Платеж не выполнен, т.к указан ошибочный код государства паспорта.
-201 Платеж не выполнен, т.к указан ошибочный код государства паспорта.
-202 Платеж не выполнен, т.к указан ошибочный код государства паспорта.
-100 общая ошибка при разборе команды. неверный формат команды.
-101 Платеж не выполнен, т.к ФИО получателя отсутствует при указанных паспортных данных
-102 Платеж не выполнен, т.к ФИО получателя платежа должно совпадать с данными владельца кошелька.
-110 запросы отсылаются не с того IP адреса, который указан при регистрации данного интерфейса.
-141 прямые пополнения кошельков продавцов запрещены
-1 Сумма платежа выше остатка на кошельке.
-2 Владелец кошелька не найден.
-3 Прием платежей на кошелек запрещен.
-4 Владельцу запрещен прием платежей.
-5 Владельцу кошелька в блек листе.
-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 данные для исполнения платежа

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