| Правильная ссылка на эту статью: |
Интерфейс A1
Интерфейс A1. Предварительный запрос на возможность проведения платежа¶
Рекомендуется выполнять до приема денежных средств от ПОЛУЧАТЕЛЯ. При выполнении этого запроса контролируются исправность технических средств (наличие связи, работоспособность и т.д.), обеспеченность средствами для реализации. Также осуществляется проверка кошелька на возможность передачи средств на кошелек соответствующего типа именно на этот кошелёк ПОЛУЧАТЕЛЯ (существует, не заблокирован, не превышен текущий лимит и т.п).
Юридическое лицо, использующее согласно договору средства аутентификации WMID, подписывающее запрос должно иметь подписанный договор с уполномоченным представителем системы WebMoney Transfer.
- URL для передачи запроса – https://transfer.gdcert.com/agent/in/xml/prepayment1.aspx
- метод – POST
- формат запроса:
<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