WebMoney

Wiki

Интерфейс ATM4

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

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

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

<w3s.request lang="en">
 <wmid></wmid>
 <sign type=""></sign>
 <payment id="" currency="" mode="" exchange="">
  <requisite></requisite>
  <provider></provider>
  <phone></phone>
  <price></price>
  <date></date>
  <point></point>
 </payment> 
</w3s.request>
  • параметры запроса:
название сущность назначение примечание
lang язык сообщений используется для установки языка ответа. Допустимые значения: "en" - английский язык, "ru" - русский язык. При отсутствии атрибута, lang ="en"
wmid тег WMID подписавшего запрос используется при авторизации с ключами WM Keeper WinPro или сертификатом X.509 WM Keeper WebPro
sign тег подпись запроса формируется из параметров: wmid + @id + @currency + @mode + requisite + provider + phone + price + date + point
sign/@type атрибут тип подписи запроса 1 - подпись сформирована с использованием специального модуля аутентификации для ключей WM Keeper WinPro, 2 - подпись сформирована с использованием сертификата X.509 WM Keeper WebPro в кодировке base64
payment/@id атрибут уникальный номер транзакции уникальный номер транзакции в системе Клиента, формируемый Клиентом. Задается целым десятичным числом, заключенным в двойные кавычки и содержит не более 18 цифр. уникальность «id» позволяет выполнять запрос на проведение платежа при пополнении повторно с тем же номером транзакции и параметрами в случае не получения ответа на запрос (обрыв связи и т.д.) или неудачном прохождении запроса. При повторном запросе с этим же номером, для уже принятого платежа, будет возвращено состояние данного платежа.
payment/@currency атрибут валюта приема платежа определяет валюту приема платежа, "USD"- платеж принят в Долларах США, ""EUR"" - платеж принят в Евро, ""RUB"" - платеж принят в Рублях (валюта доступна только при указании валюты зачисления платежа) .
payment/@exchange атрибут валюта зачисление платежа параметр не обязательный и определяет валюту зачисления платежа, "USD"- Доллары США, ""EUR"" - Евро. При отсутствии соответствует валюте приема платежа
payment/@mode атрибут режим запроса определяет режим запроса и имеет два значения, "1"- предварительный запрос на возможность проведения платежа, "0" - запрос на проведения платежа.
payment/requisite тег пополняемый реквизит строка – 50 символов, содержащая номер телефона, номер договора, wm кошелёк получателя. пробелы и знак + не допускаются
payment/provider тег номер провайдера пополнения 0 - пополнение WM кошелька (разрешенные типы Z, E, R), 1,2,3 - оплата услуг МТС, Билайн, Мегафон. Задается целым десятичным числом и содержит не более 5 цифр.
payment/phone тег контактный мобильный телефон ПЛАТЕЛЬЩИКА строка – код страны, код оператора, номер телефона; пробелы и знак + не допускаются
payment/price тег сумма принятая от плательщика число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)
payment/date тег дата платежа определяет дату и время приема платежа по местному времени. соответствует значению поля «Дата платежа» на форме документа, подтверждающего реализацию ЭЧП. имеет формат YYYYMMDD HH:mm:ss, где YYYY – число года, MM – число месяца, DD – число дня, HH – часы, mm – минуты, ss – секунды
payment/point тег уникальный идентификатор точки пополнения определяет уникальный идентификатор точки пополнения. задается целым десятичным числом и содержит не более 16 цифр
  • формат ответа:
<w3s.response>
 <retval></retval>
 <retdesc></retdesc>
 <payment id="" currency="" mode="" exchange="">
  <requisite></requisite>
  <provider></provider>
  <phone></phone>
  <price></price>
  <amount></amount>
  <comiss></comiss>
  <rest></rest>
  <date></date>
  <point></point>
  <wmtranid></wmtranid>
  <tranid></tranid>
  <dateupd></dateupd>
  <limit>
   <day></day>
   <month></month>
  </limit>
 </payment> 
</w3s.response>
  • параметры ответа:
название сущность назначение примечание
retval тег код состояния или ошибки 0 - запрос выполнен успешно. другие значения кодов ответа говорят о неудачном прохождении запроса.
retdesc тег текстовое описание ошибки/пусто текст описания ошибки. произвольная строка от 0 до 255 символов; кодировка win-1251
payment/@id атрибут уникальный номер транзакции уникальный номер транзакции в системе Клиентом, формируемый Клиентом. Задается целым десятичным числом, заключенным в двойные кавычки и содержит не более 18 цифр. уникальность «id» позволяет выполнять запрос на проведение платежа при пополнении повторно с тем же номером транзакции и параметрами в случае не получения ответа на запрос (обрыв связи и т.д.) или неудачном прохождении запроса. При повторном запросе с этим же номером, для уже принятого платежа, будет возвращено состояние данного платежа.
payment/@currency атрибут валюта платежа определяет валюту платежа, "USD"- платеж принят в Долларах США, "EUR" - платеж принят в Евро.
payment/@mode атрибут режим запроса определяет режим запроса и имеет два значения, "1"- предварительный запрос на возможность проведения платежа, "0" - запрос на проведения платежа.
payment/@exchange атрибут валюта зачисление платежа параметр не обязательный и определяет валюту зачисления платежа, "USD"- Доллары США, ""EUR"" - Евро. При отсутствии соответствует валюте приема платежа
payment/requisite тег пополняемый реквизит строка – 50 символов, содержащая номер телефона, номер договора, wm кошелёк получателя. пробелы и знак + не допускаются
payment/provider тег номер провайдера пополнения задается целым десятичным числом и содержит не более 5 цифр.
payment/phone тег контактный мобильный телефон ПЛАТЕЛЬЩИКА строка – код страны, код оператора, номер телефона; пробелы и знак + не допускаются
payment/price тег сумма принятая от плательщика число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)
payment/date тег дата платежа определяет дату и время приема платежа по местному времени. имеет формат YYYYMMDD HH:mm:ss, где YYYY – число года, MM – число месяца, DD – число дня, HH – часы, mm – минуты, ss – секунды
payment/point тег уникальный идентификатор точки пополнения определяет уникальный идентификатор точки пополнения. задается целым десятичным числом и содержит не более 16 цифр
payment/amount тег сумма пополнения на кошелек число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)
payment/comiss тег комиссия пополнения число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)
payment/rest тег остаток средств обеспечения возвращает остаток средств обеспечения, возможных для реализации. Задается десятичным числом с точностью до второго знака (разделитель - .(точка) ). Следующая реализация платежа может быть выполнена на сумму, не превышающее возвращенное значение остатка
payment/wmtranid тег номер транзакции в системе WMT уникальный номер операции в системе WMT. задается целым десятичным числом и содержит не более 16 цифр
payment/tranid тег номер операции уникальный номер операции в системе. задается целым десятичным числом и содержит не более 16 цифр
payment/dateupd тег дата операции по "часам" системы дату операции по "часам" системы. имеет формат YYYYMMDD HH:mm:ss, где YYYY – число года, MM – число месяца, DD – число дня, HH – часы, mm – минуты, ss – секунды
payment/limit/day тег максимально возможная сумма пополнения на реквизиты Пользователя в сутки число с плавающей точкой (разделитель - .(точка) )
payment/limit/month тег максимально возможная сумма пополнения на реквизиты Пользователя в месяц число с плавающей точкой (разделитель - .(точка) )
payment/upexchange тег сумма принятая от плательщика, при указании атрибута payment/@exchange число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)
payment/course тег курс конвертации, при указании атрибута payment/@exchange число с плавающей точкой (разделитель - .(точка)) и для десяти с половиной может выглядеть так: 10.5; незначащие нули в конце и точка, если число целое, должны отсутствовать, например, 10.50 - не верно, 10.5 - верно, 9. - не верно, 9 - верно)
  • примеры XML запросов:

1) проверка на возможность проведения платежа на WM кошелек

  • запрос
    <w3s.request>
    <wmid>35********32</wmid>
    <sign type="1">e4d937fc647a107d3de474d9caf2b29dc973a3fda57138768ee9e85d15576f8d4d9a5c52633300f36cb39f1dd744d8a957165b3260c0cda0fd9054d62c57ca640015</sign>
    <payment id="185" mode="1" currency="RUB" exchange="USD">
       <requisite>R773257789242</requisite>
       <provider>0</provider>
       <phone>79168704084</phone>
      <price>100.12</price>
      <date>20140505 18:00:00</date>
      <point>12</point>
    </payment>
    </w3s.request>
    
  • ответ
    <w3s.response>
    <retval>0</retval>
    <retdesc><![CDATA[Запрос успешно обработан]]></retdesc>
    <payment id="185" currency="RUB" exchange="USD" mode="1">
        <requisite>R773257789242</requisite>
        <provider>0</provider>
        <phone>79168704084</phone>
        <date>20140505 18:00:00</date>
        <point>12</point>
            <price>2.68</price>
            <amount>2</amount>
            <comiss>0.68</comiss>
            <wmtranid>130475760170557942</wmtranid>
            <tranid>635387136170557942</tranid>
            <dateupd>20140505 18:01:00</dateupd>
            <rest>4.88</rest>
        <limit>
            <day>498.85</day>
            <month>4998.73</month>
        </limit>
        <upexchange>100.12</upexchange>
        <course>37.33</course>
    </payment>
    </w3s.response>
    

2) проведение платежа на WM кошелек

  • запрос
    <w3s.request>
    <wmid>35********32</wmid>
    <sign type="1">e4d937fc647a107d3de474d9caf2b29dc973a3fda57138768ee9e85d15576f8d4d9a5c52633300f36cb39f1dd744d8a957165b3260c0cda0fd9054d62c57ca547075</sign>
    <payment id="185" mode="0" currency="RUB" exchange="USD">
       <requisite>R773257789242</requisite>
       <provider>0</provider>
       <phone>79168704084</phone>
      <price>100.12</price>
      <date>20140505 18:00:00</date>
      <point>12</point>
    </payment>
    </w3s.request>
    
  • ответ
    <w3s.response>
    <retval>0</retval>
    <retdesc><![CDATA[Платеж успешно зачислен]]></retdesc>
    <payment id="185" currency="RUB" exchange="USD" mode="0">
        <requisite>R773257789242</requisite>
        <provider>0</provider>
        <phone>79168704084</phone>
        <date>20140505 18:00:00</date>
        <point>12</point>
            <price>2.68</price>
            <amount>2</amount>
            <comiss>0.68</comiss>
            <wmtranid>13047576</wmtranid>
            <tranid>170557942</tranid>
            <dateupd>20140505 18:02:00</dateupd>
            <rest>4.88</rest>
        <limit>
            <day>498.85</day>
            <month>4998.73</month>
        </limit>
        <upexchange>100.12</upexchange>
        <course>37.33</course>
    </payment>
    </w3s.response>
    

3) проверка на возможность оплаты услуг МТС

  • запрос
    <w3s.request>
    <wmid>35********32</wmid>
    <sign type="1">e4d937fc647a107d3de474d9caf2b29dc973a3fda57138768ee9e85d15576f8d4d9a5c52633300f36cb39f1dd744d8a957165b3260c0cda0fd9054d62c546ada737a</sign>
    <payment id="186" mode="1" currency="RUB">
       <requisite>9168704084</requisite>
       <provider>1</provider>
       <phone>79168704084</phone>
      <price>400</price>
      <date>20140505 19:00:00</date>
      <point>12</point>
    </payment>
    </w3s.request>
    
  • ответ
    <w3s.response>
    <retval>0</retval>
    <retdesc>
    <![CDATA[Запрос успешно обработан]]>
    </retdesc>
    <payment id="186" currency="RUB" mode="1">
    <requisite>9168704084</requisite>
    <provider>1</provider>
    <phone>79168704084</phone>
    <date>20140505 19:00:00</date>
    <point>12</point>
    <price>400</price>
    <amount>387.97</amount>
    <comiss>12.03</comiss>
    <wmtranid>130500589733541270</wmtranid>
    <tranid>635411965733541270</tranid>
    <dateupd>20140717 12:22:53</dateupd>
    <rest>28.91</rest>
    <limit>
    <day>196</day>
    <month>996</month>
    </limit>
    </payment>
    </w3s.response>
    

4) проведение оплаты услуг МТС

  • запрос
    <w3s.request>
    <wmid>35********32</wmid>
    <sign type="1">e4d937fc647a107d3de474d9caf2b29dc973a3fda57138768ee9e85d15576f8d4d9a5c52633300f36cb39f1dd744d8a957165b3260c0cda0fd9054d62c34ca64ad18</sign>
    <payment id="186" mode="0" currency="RUB" exchange="USD">
       <requisite>9168704084</requisite>
       <provider>1</provider>
       <phone>79168704084</phone>
      <price>400</price>
      <date>20140505 19:00:00</date>
      <point>12</point>
    </payment>
    </w3s.request>
    
  • ответ
    <w3s.response>
    <retval>0</retval>
    <retdesc>
    <![CDATA[ Платеж успешно зачислен ]]>
    </retdesc>
    <payment id="186" currency="RUB" mode=01">
    <requisite>9168704084</requisite>
    <provider>1</provider>
    <phone>79168704084</phone>
    <date>20140505 19:00:00</date>
    <point>12</point>
    <price>400</price>
    <amount>387.97</amount>
    <comiss>12.03</comiss>
    <wmtranid>130500589</wmtranid>
    <tranid>3541270</tranid>
    <dateupd>20140717 12:22:53</dateupd>
    <rest>28.91</rest>
    <limit>
    <day>196</day>
    <month>996</month>
    </limit>
    </payment>
    </w3s.response>
    

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