| Правильная ссылка на эту статью: |
Интерфейс A2
Интерфейс A2. Запрос на проведения платежа¶
Рекомендуется выполнять после успешного выполнения Предварительного запроса. Если при выполнении этого запроса был получен отрицательный ответ, необходимо, после устранения причин повторить этот запрос с тем же номером уникальным id (во избежание двойного зачисления) до получения положительного ответа. Платеж считается принятым, если при выполнении запроса был получен положительный ответ <retval>0</retval>.
Юридическое лицо, использующее согласно договору средства аутентификации WMID, подписывающее запрос должно иметь подписанный договор с уполномоченным представителем системы WebMoney Transfer.
- URL для передачи — https://transfer.gdcert.com/agent/in/xml/payment1.aspx
- метод – POST
- формат запроса:
<w3s.request> <wmid></wmid> <sign type=""></sign> <payment id="" test=""> <pspname></pspname> <pspcode></pspcode> <pspnumber></pspnumber> <pspdate></pspdate> <purse></purse> <price></price> <cheque></cheque> <date></date> <kiosk_id></kiosk_id> </payment> </w3s.request>
- параметры запроса:
| название | назначение | примечание |
| wmid | WMID подписавшего запрос | используется при авторизации с ключами WM Keeper WinPro или сертификатом X.509 WM Keeper WebPro |
| sign | подпись запроса | формируется из параметров: wmid + id+ test + pspname+ pspcode+ pspnumber+ pspdate purse+price+cheque date+ kiosk_id |
| sign/@type | тип подписи запроса | 1 - подпись сформирована с использованием специального модуля аутентификации для ключей WM Keeper WinPro, 2 - подпись сформирована с использованием сертификата X.509 WM Keeper WebPro в кодировке base64 |
| payment/@id | уникальный номер транзакции | "уникальный номер транзакции в системе Агента, формируемый Агентом. Задается целым десятичным числом, заключенным в двойные кавычки и содержит не более 18 цифр. уникальность «id» позволяет выполнять запрос на проведение платежа при реализации ЭЧП повторно с тем же номером транзакции и параметрами в случае не получения ответа на запрос (обрыв связи и т.д.) или неудачном прохождении запроса. При повторном запросе с этим же номером, для уже принятого платежа, будет возвращено состояние данного платежа. атрибут «test» определяет режим запроса и имеет два значения ""0"" или ""1"". «test» равен ""1""- платеж проводится в тестовом режиме, «test» равен ""0"" - платеж реальный. примечание: номер id должен быть уникальным для тестовых и реальных запросов. Если id был использован для тестового запроса, его нельзя использовать для реального запроса" |
| payment/@test | режим запроса | "определяет режим запроса и имеет два значения, ""1""- платеж проводится в тестовом режиме, ""0"" - платеж реальный." |
| 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/cheque | номер документа выданного Пользователю Агентом | определяет номер документа выданного Пользователю Агентом. задается целым десятичным числом и содержит не более 16 цифр. соответствует значению поля «Номер документа» на форме документа, подтверждающего реализацию ЭЧП |
| payment/date | дата операции по «часам» Агента | "определяет дату и время приема платежа по ""часам"" Агента. соответствует значению поля «Дата платежа» на форме документа, подтверждающего реализацию ЭЧП. имеет формат YYYYMMDD HH:mm:ss, где YYYY – число года, MM – число месяца, DD – число дня, HH – часы, mm – минуты, ss – секунды" |
| payment/kiosk_id | уникальный идентификатор точки реализации ЭЧП | определяет уникальный идентификатор точки реализации ЭЧП. задается целым десятичным числом и содержит не более 16 цифр. соответствует значению поля «Уникальный идентификатор точки реализации ЭЧП» на форме документа, подтверждающего реализацию ЭЧП |
- формат ответа:
<w3s.response> <retval></retval> <retdesc></retdesc> <payment> <pspname></pspname> <pspcode></pspcode> <pspnumber></pspnumber> <pspdate></pspdate> <price></price> <amount></amount> <comiss></comiss> <rest></rest> <purse></purse> <cheque></cheque> <date></date> <kiosk_id></kiosk_id> <wmtranid></wmtranid> <dateupd></dateupd> <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/amount | сумма пополнения на кошелек | "число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5, незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)" |
| payment/comiss | комиссия пополнения | "число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5, незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)" |
| payment/rest | остаток средств обеспечения | возвращает остаток средств обеспечения, возможных для реализации. Задается десятичным числом с точностью до второго знака (разделитель - .(точка)). Следующая реализация платежа может быть выполнена на сумму, не превышающее возвращенное значение остатка |
| payment/cheque | номер документа выданного Пользователю Агентом | номер документа выданного Пользователю Агентом. задается целым десятичным числом и содержит не более 16 цифр. соответствует значению поля «Номер документа» на форме документа, подтверждающего реализацию ЭЧП |
| payment/date | дата операции по «часам» Агента | "дата и время приема платежа по ""часам"" Агента. соответствует значению поля «Дата платежа» на форме документа, подтверждающего реализацию ЭЧП. имеет формат YYYYMMDD HH:mm:ss, где YYYY – число года, MM – число месяца, DD – число дня, HH – часы, mm – минуты, ss – секунды" |
| payment/kiosk_id | уникальный идентификатор точки реализации ЭЧП | уникальный идентификатор точки реализации ЭЧП. задается целым десятичным числом и содержит не более 16 цифр. соответствует значению поля «Уникальный идентификатор точки реализации ЭЧП» на форме документа, подтверждающего реализацию ЭЧП |
| payment/wmtranid | номер транзакции в системе WebMoney Transfer | уникальный номер операции в системе WebMoney Transfer |
| payment/dateupd | "дата операции по ""часам"" WebMoney Transfer" | "дату операции по ""часам"" WebMoney Transfer. имеет формат YYYYMMDD HH:mm:ss, где YYYY – число года, MM – число месяца, DD – число дня, HH – часы, mm – минуты, ss – секунды" |
| 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 данные для исполнения платежа |
| -53100 | общая ошибка при разборе команды. неверный формат команды. |
| -53102 | не выполнено условие постоянного увеличения значения параметра w3s.request/reqn |
| -53103 | транзакция с таким значением поля w3s.request/trans/tranid уже выполнялась |
| -53110 | нет доступа к интерфейсу или запросы отсылаются не с того IP адреса |
| -53111 | попытка перевода с кошелька не принадлежащего WMID, которым подписывается запрос; при этом доверие не установлено. |
| -531 | неверное значение поля w3s.request/reqn |
| -532 | неверное значение поля w3s.request/sign |
| -533 | неверное значение поля w3s.request/trans/tranid |
| -534 | внутренняя ошибка при создании транзакции или неверное значение поля w3s.request/trans/pursesrc |
| -535 | идентификатор отправителя не найден или неверное значение поля w3s.request/trans/pursedest |
| -536 | корреспондент не найден или неверное значение поля w3s.request/trans/amount |
| -537 | кошелек получателя не найден или неверное значение поля w3s.request/trans/desc |
| -5311 | кошелек отправителя не найден или неверное значение поля w3s.request/trans/wminvid |
| -5312 | идентификатор переданный в поле w3s.request/wmid не зарегистрирован |
| -5314 | проверка подписи не прошла |
| -5313 | сумма транзакции должна быть больше нуля |
| -5315 | внутренняя ошибка при создании транзакции или неверное значение поля w3s.request/wmid |
| -5317 | недостаточно средств в кошельке для выполнения операции (исчерпан лимит, если происходит перевод с кошелька через механизм доверия) или не передан признак деноминации |
| -5318 | указанная транзакция (wmtransid) не найдена, возникает, например, когда указанная к возврату и завершению операция с протекцией уже завершена или возвращена |
| -5319, -5323 | внутренняя ошибка при создании транзакции |
| -5320 | указанный для завершения транзакции с протекцией код протекции неверен |
| -5321 | счет, по которому совершается оплата не найден |
| -5322 | по указанному счету оплата с протекцией не возможна |
| -5325 | время действия оплачиваемого счета закончилось |
| -5326 | в операции должны участвовать разные кошельки |
| -5329 | типы кошельков отличаются |
| -5330 | кошелек не поддерживает прямой перевод (например для кредитных кошельков C или D) |
| -5332, -5334 | плательщику необходимо заполнить персональную информацию на сайте Центра Аттестации |
| -5335 | плательщик не авторизован корреспондентом для выполнения данной операции |
| -5358 | превышен лимит средств на кошельках получателя |
| -5372 | Обслуживание на вывод средств в WME временно приостановлено, ознакомьтесь с требованиями Гаранта по идентификации |
| -5373, -5374 | Обслуживание получателя средств в WME временно приостановлено, ознакомьтесь с требованиями Гаранта по идентификации |
| -5375 | Код протекции должен иметь длину не меньше 5-ти символов |
| -5397 | Отправитель перевода не акцептовал соглашение о смене гаранта по WME |
| -5398 | Получатель перевода не акцептовал соглашение о смене гаранта по WME |
См. также
XML-интерфейсы зачисления WMZ и WME