Web-сервисы ASSIST

Оглавление

WS2 - Получение результатов авторизации. 3

Список принимаемых параметров: 3

Описание Веб-сервиса. 4

SOAP request 4

SOAP response. 4

WS3 - Получение курса валют. 5

Список принимаемых параметров: 5

Описание Веб-сервиса. 5

SOAP request 5

SOAP response. 6

WS4 - Определение страны-эмитента карты.. 6

Передаваемые параметры: 6

Описание Веб-сервиса. 6

SOAP request 6

SOAP response. 7

Финансовое подтверждение. 7

Список принимаемых параметров: 7

Описание Веб-сервиса. 8

SOAP request 8

SOAP response. 8


WS2 - Получение результатов авторизации

Для получения результатов авторизации необходимо отправить запрос в формате SOAP, HTTP POST или HTTP GET на URL: https://secure. assist. ru/results/results. cfm

Временной интервал получения результатов авторизации ограничен. По запросу предоставляются результаты авторизации за последние 3 дня. В случае если в запросе значения даты начала транзакции (StartHour, StartDay, StartMonth, StartYear) превышает 3 дня, дата начала транзакции автоматически становится: текущая дата "минус" 3 дня.

Список принимаемых параметров:

Параметр

Принимаемые значения

Обязательное поле

Значение по умолчанию

Пояснения

ShopOrderNumber

Да

Номер заказа

Shop_IDP

Да

Магазин ID

Login

Да

Логин

Password

Да

Пароль

SUCCESS

0 – неуспешных

1 – успешных

2 - всех

Нет

Отбор операций

STARTHOUR

Да

Час начала периода

STARTDAY

Да

День начала периода

STARTMONTH

Да

Месяц начала периода

STARTYEAR

Да

Год начала периода

ENDHOUR

Да

Час конца периода

ENDDAY

Да

День конца периода

ENDMONTH

Да

Месяц конца периода

ENDYEAR

Да

Год конца периода

MEANTYPE

Да

Платежное средство

PAYMENTTYPE

Да

Тип платежа

FORMAT

1 - CSV
2 - WDDX
3 - XML
4 - SOAP

Нет

1

Формат выдачи результата

ZIPFLAG

0 – браузер

1 – файл

2 – архивированный файл

Нет

0

Куда выдавать результат

LANGUAGE

0 – русский

1 – английский

Да

1

Язык

HEADER

Выводить заголовок:

0 – нет

1 – да

Нет

0

Заголовок

HEADER1

Выводить заголовки полей:

0 – нет

1 – да

Нет

0

Заголовок полей

Delimiter

Нет

Разделитель полей

OpenDelimiter

Нет

Начало поля

CloseDelimiter

Нет

Конец поля

RowDelimiter

Нет

Разделитель строк

Описание Веб-сервиса https://secure. assist. ru/results/results. wsdl

НЕ нашли? Не то? Что вы ищете?

SOAP request

<s:Envelope xmlns:s="http://schemas. xmlsoap. org/soap/envelope/">

<s:Body>

<getpaymentresult xmlns="urn:assist-processor">

<shop_id>111111</shop_id>

<login>testshop</login>

<password>123123</password>

<shopordernumber>tt18</shopordernumber>

<success>0</success>

<starthour>10</starthour>

<startday>10</startday>

<startmonth>10</startmonth>

<startyear>06</startyear>

<endhour>10</endhour>

<endday>11</endday>

<endmonth>10</endmonth>

<endyear>06</endyear>

<meantype>0</meantype>

<paymenttype>0</paymenttype>

<english>1</english>

</getpaymentresult>

</s:Body>

</s:Envelope>

SOAP response

<?xml version="1.0" encoding="windows-1251" standalone="yes" ?>

  <!DOCTYPE assistresult (View Source for full doctype...)>

- <assistresult firstcode="0" secondcode="0" count="1">

- <orders>

- <order>

  <ordernumber>tt18</ordernumber>

  <response_code>AS000</response_code>

  <recommendation>SUCCESSFUL AUTHORIZATION</recommendation>

  <message>APPROVED.</message>

  <comment>n/a</comment>

  <date>01.09.2006 13:24:48</date>

  <total>45.00</total>

  <currency>RUR</currency>

  <cardtype>EC/MC</cardtype>

  <cardnumber>546792****4128</cardnumber>

  <lastname>Not</lastname>

  <firstname>Available</firstname>

  <middlename />

  <address>n/a</address>

  <email>*****@***ru</email>

  <country>USA</country>

  <rate>0.0000</rate>

  <approvalcode>FAKE</approvalcode>

  <cardsubtype>UNKNOWN</cardsubtype>

  <cvc2>1</cvc2>

  <cardholder>titov</cardholder>

  <ipaddress>127.0.0.1</ipaddress>

  <protocoltypename>POS</protocoltypename>

  <billnumber>320645215736622</billnumber>

  <bankname>BANK OF NOVA SCOTIA, THE</bankname>

  <status>Authorized</status>

  <error_code>PM000</error_code>

  <error_comment>approved</error_comment>

  <packetdate>04.09.2006 18:41:40</packetdate>

  <signature>iQCVAwUARPwQ9fGmoI3VOqQJAQFV0wP/SfDkBIxTzMyMQeC7D0+PJo4rpJ6/tIao RkV0VHDUpzfWPU8/A4sXynLUkEzEvqSxMeWjzfKRv8l+C6St1T4H6YzOdkJeZc9c rNbycYtMpGbWucL7vDnPEJol5zdg51sepijBRfD4WBwCBdFobrtZmRkSrxEfFzm4 XksafCsd5R0= =fCPO</signature>

  <processingname>Fake</processingname>

  </order>

  </orders>

  </assistresult>

WS3 - Получение курса валют

Получить курсы валют на любую дату можно, послав SOAP, HTTP POST или HTTP GET запрос на сервер ASSIST по адресу https://secure. assist. ru/rate/rateusd. cfm

Список принимаемых параметров:

Параметр

Принимаемые значения

Обязательное поле

Значение по умолчанию

Пояснения

DATE

Дата в формате дд. мм. гггг

нет

текущая дата

Дата

SHOP_ID

да

Идентификатор магазина

LOGIN

да

Логин

PASSWORD

да

Пароль

CURRENCY

Код валюты в формате 3 буквы

нет

USD

Код валюты

FORMAT

1 - CSV
2 - WDDX
3 - XML
4 - SOAP

нет

1

Формат выдаваемого результата

Описание Веб-сервиса https://secure. assist. ru/rate/rate. wsdl

SOAP request

<s:Envelope xmlns:s="http://schemas. xmlsoap. org/soap/envelope/">

<s:Body>

<getrate xmlns="urn:assist-processor">

<shop_id>111111</shop_id>

<login>testshop</login>

<password>123123</password>

<currency>USD</currency>

<date>05.09.06</date>

</getrate>

</s:Body>

</s:Envelope>

SOAP response

<?xml version="1.0" encoding="windows-1251" standalone="no" ?>

- <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas. xmlsoap. org/soap/envelope/" SOAP-ENV:encodingStyle="http://schemas. xmlsoap. org/soap/encoding/" xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www. w3.org/2001/XMLSchema">

- <SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas. xmlsoap. org/soap/encoding/">

- <ASS-NS:GetRateResponse xmlns:ASS-NS="http://www. assist. ru/message/">

- <return xmlns:si="http://www. assist. ru/type/" xsi:type="si:SOAPStruct">

  <currency xsi:type="xsd:string">USD</currency>

  <date xsi:type="xsd:string">05.09.2006</date>

  <rate xsi:type="xsd:string">26.7542</rate>

  </return>

  </ASS-NS:GetRateResponse>

  </SOAP-ENV:Body>

  </SOAP-ENV:Envelope>

WS4 - Определение страны-эмитента карты

Для определения страны - эмитента кредитной карты по ее номеру необходимо отправить запрос на адрес https://secure. assist. ru/countries/country. cfm.

Передаваемые параметры:

Параметр

Значения

Обязательное поле

Значение по умолчанию

Пояснения

CARDNUMBER

да

Номер кредитной карты

SHOP_ID

да

Идентификатор магазина

LOGIN

да

Логин

PASSWORD

да

Пароль

FORMAT

1 - CSV
2 - WDDX
3 - XML
4 - SOAP

нет

1

Формат выдаваемого результата

Описание Веб-сервиса https://secure. assist. ru/countries/country. wsdl

SOAP request

<s:Envelope xmlns:s="http://schemas. xmlsoap. org/soap/envelope/">

<s:Body>

<getcardinfo xmlns="urn:assist-processor">

<shop_id>111111</shop_id>

<login>testshop</login>

<password>123123</password>

<cardnumber>4111111111111111</cardnumber>

</getcardinfo>

</s:Body>

</s:Envelope>

SOAP response

<?xml version="1.0" encoding="windows-1251" standalone="no" ?>

- <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas. xmlsoap. org/soap/envelope/" SOAP-ENV:encodingStyle="http://schemas. xmlsoap. org/soap/encoding/" xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www. w3.org/2001/XMLSchema">

- <SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas. xmlsoap. org/soap/encoding/">

- <ASS-NS:GetCardInfoResponse xmlns:ASS-NS="http://www. assist. ru/message/">

- <return xmlns:si="http://www. assist. ru/type/" xsi:type="si:SOAPStruct">

  <country xsi:type="xsd:string">RUS</country>

  <cardnumber xsi:type="xsd:string">4111111111111111</cardnumber>

  <bankname xsi:type="xsd:string">ASSIST</bankname>

  <bin xsi:type="xsd:string">4111111111111111</bin>

  <cardtype xsi:type="xsd:string">VISA</cardtype>

  <cardsubtype xsi:type="xsd:string">AlfaVisaC</cardsubtype>

  </return>

  </ASS-NS:GetCardInfoResponse>

  </SOAP-ENV:Body>

  </SOAP-ENV:Envelope>

Финансовое подтверждение

URL для передачи запроса: https://secure. assist. ru/postauths/postauth. cfm

Список принимаемых параметров:

№

Параметр

Принимаемые значения

Обя-
зат. поле

Значение по умолчанию

Пояснения

1.

BILLNUMBER

да

Номер платежа в ASSIST

2.

SHOP_ID

да

Идентификатор магазина

3.

LOGIN

да

Логин

4.

PASSWORD

да

Пароль

5.

SUBTOTAL_P

нет

Сумма финансового подтверждения

Сумма финансового подтверждения

6.

FORMAT

1 - CSV
2 - WDDX
3 - XML
4 - SOAP

нет

1

Формат выдачи результата.
1 - поля с разделителями
2 - WDDX
3 - XML
4 - SOAP (Веб-сервис)

7.

CURRENCY

RUR
USD
EUR

нет

RUR

Код валюты, в которой указана сумма финансового подтверждения Subtotal_P (список кодов валют).

8.

LANGUAGE

0-русский
1-английский

нет

1

Язык выдачи результатов.

9.

PROTECTCODE

нет

Код протекции для WebMoney (в случае оплаты с протекцией сделки)

10.

S_FIELDS

нет

*

заголовки и имена выводимых полей (формат описан ниже) или * (все поля)

Описание Веб-сервиса https://secure. assist. ru/postauths/postauth. wsdl

SOAP request

<s:Envelope xmlns:s="http://schemas. xmlsoap. org/soap/envelope/">

<s:Body>

<makepostauth xmlns="urn:assist-processor">

<billnumber>320645215752058</billnumber>

<shop_id>111111</shop_id>

<login>testshop</login>

<password>123123</password>

<subtotal_p>11</subtotal_p>

<currency>RUR</currency>

<language>0</language>

<protectcode></protectcode>

</makepostauth>

</s:Body>

</s:Envelope>

SOAP response

<?xml version="1.0" encoding="windows-1251" standalone="no" ?>

- <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas. xmlsoap. org/soap/envelope/" SOAP-ENV:encodingStyle="http://schemas. xmlsoap. org/soap/encoding/" xmlns:xsi="http://www. w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www. w3.org/2001/XMLSchema">

- <SOAP-ENV:Body SOAP-ENV:encodingStyle="http://schemas. xmlsoap. org/soap/encoding/">

- <ASS-NS:MakePaymentResponse xmlns:ASS-NS="http://www. assist. ru/message/">

- <return xmlns:si="http://www. assist. ru/type/" xsi:type="si:SOAPStruct">

  <ordernumber xsi:type="xsd:string">nz11</ordernumber>

  <response_code xsi:type="xsd:string">AS020</response_code>

  <recommendation xsi:type="xsd:string">ПОСТАВТОРИЗАЦИЯ УСПЕШНО ЗАВЕРШЕНА</recommendation>

  <message xsi:type="xsd:string">Операция успешно завершена.</message>

  <comment xsi:type="xsd:string">PostAuth</comment>

  <date xsi:type="xsd:string">06.09.2006 13:37:25</date>

  <total xsi:type="xsd:string">11.00</total>

  <currency xsi:type="xsd:string">RUR</currency>

  <cardtype xsi:type="xsd:string">EC/MC</cardtype>

  <cardnumber xsi:type="xsd:string">* 4128</cardnumber>

  <lastname xsi:type="xsd:string">Test</lastname>

  <firstname xsi:type="xsd:string">Me</firstname>

  <middlename xsi:type="xsd:string">S.</middlename>

  <address xsi:type="xsd:string">piter,2,3</address>

  <email xsi:type="xsd:string">*****@***ru</email>

  <country xsi:type="xsd:string">USA</country>

  <rate xsi:type="xsd:string">0.00</rate>

  <approvalcode xsi:type="xsd:string">FAKE</approvalcode>

  <cardsubtype xsi:type="xsd:string">UNKNOWN</cardsubtype>

  <cvc2 xsi:type="xsd:string">1</cvc2>

  <cardholder xsi:type="xsd:string">Test Me</cardholder>

  <ipaddress xsi:type="xsd:string">112.23.23.23</ipaddress>

  <protocoltypename xsi:type="xsd:string">NET</protocoltypename>

  <billnumber xsi:type="xsd:string">320645215752058</billnumber>

  <bankname xsi:type="xsd:string">BANK OF NOVA SCOTIA, THE</bankname>

  <status xsi:type="xsd:string">Authorized</status>

  <error_code xsi:type="xsd:string">PM000</error_code>

  <error_comment xsi:type="xsd:string">approved</error_comment>

  <packetdate xsi:type="xsd:string">06.09.2006 13:37:33</packetdate>

  <signature xsi:type="xsd:string">iQCVAwUARP5srvGmoI3VOqQJAQHBQAP9FnVvFEW3EgH+aSq72lfU0svSFMxcYUiN 9d8r3pTbvMCI+zklKotO3SKr8Q0R9OFCQNwkg4UvpWTNnuNPhThuKoq71q2JYLom g1mpoAxRWP+fZn1hcKd1sd4byECAJIpUDD+dsm82XZCE5Pmxs/YdhG0thmNzUHcC VbEYt4/VKaA= =sd8J</signature>

  <processingname xsi:type="xsd:string">Fake</processingname>

  </return>

  </ASS-NS:MakePaymentResponse>

  </SOAP-ENV:Body>

  </SOAP-ENV:Envelope>