WebMoney

Wiki

Интерфейс A2

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

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

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

<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 номер транзакции в системе WMT уникальный номер операции в системе WMT
payment/dateupd "дата операции по ""часам"" WMT" "дату операции по ""часам"" WMT. имеет формат YYYYMMDD HH:mm:ss, где YYYY – число года, MM – число месяца, DD – число дня, HH – часы, mm – минуты, ss – секунды"
payment/limit/day максимально возможная сумма реализации на кошелёк Пользователя в сутки число с плавающей точкой (разделитель - .(точка) )
payment/limit/month максимально возможная сумма реализации на кошелёк Пользователя в месяц число с плавающей точкой (разделитель - .(точка) )

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