Page History
Для оповещения предприятия о результате платежа в режиме реального времени система АПК Ассист предоставляет сервис синхронной асинхронной отправки результатов платежа на сервер предприятия. После завершения покупателем оплаты заказа (при помощи банковской карты или одного из средств электронной наличности) на сервер предприятия методом HTTP POST или SOAP отправляется сообщение с параметрами платежа.
...
Для работы сервиса по протоколу HTTPS необходимо использовать сертификат доверенного центра сертификации или обратиться в службу поддержки (support@assist.ru) для получения персонального сертификата.
Список отправляемых параметров:
| Название | Значение | 
| merchant_id | Идентификатор предприятия | 
| ordernumber | Номер заказа | 
| billnumber | Полный уникальный номер операции в системе | 
| testmode | Тестовый режим | 
| ordercomment | Комментарий | 
| orderamount | Оригинальная сумма заказа | 
| ordercurrency | Оригинальная валюта заказа | 
| amount | Сумма операции | 
| currency | Валюта операции | 
| rate | Курс валюты | 
| firstname | Имя плательщика | 
| lastname | Фамилия плательщика | 
| middlename | Отчество плательщика | 
| Email плательщика | |
| clientip | IP-адрес совершившего операцию | 
| ipaddress | IP-адрес плательщика | 
| meantype_id | ID платежного средства | 
| meantypename | Тип платежного средства | 
| meansubtype | Подтип платежного средства | 
| meannumber | Номер платежного средства | 
| cardholder | Держатель платежного средства | 
| cardexpirationdate | Срок действия карты | 
| issuebank | Название банка-эмитента | 
| bankcountry | Страна банка-эмитента | 
| orderdate | Дата заказа по Гринвичу (GMT) | 
| orderstate | Cтатус заказа | 
| responsecode | Код возврата | 
| message | Сообщение | 
| customermessage | Сообщение о результате для покупателя | 
| recommendation | Рекомендации | 
| approvalcode | Код авторизации | 
| protocoltypename | Протокол | 
| processingname | Процессинг | 
| operationtype | Тип операции | 
| operationdate | Дата и время операции (GMT) | 
| authresult | Результат авторизации по 3DSecure (Y - успешно, N - неуспешно, A - Attempt, U – неизвестно, R- отказ, C – не завершено по каким-либо причинам, E - ошибка) | 
| authrequired | Результат проверки вовлеченности карты (1 – вовлечена, 0 – не вовлечена, -1 – неизвестно, null – ошибка при определении вовлеченности) | 
| packetdate | Дата формирования запроса по Гринвичу (GMT) | 
| signature | 1) Для типа подписи MD5 - пусто 2) Для типа PGP – значение X, подписанное закрытым ключом АПК Ассист, закодированное в BASE64 | 
| checkvalue | Контрольный код сообщения. 1) Для типа подписи MD5 вычисляется по формуле: uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – результат строковой склейки параметров merchant_id, ordernumber, amount, currency, orderstate (без разделителей); + - строковая склейка. 2) Для типа PGP - пусто | 
| errorcategory*** | Категория ответов при неуспешных оплатах, полученная от VISA | 
| merchantadvicecode*** | |
| slipno | Номер финансовой транзакции, отправляемый в процессинг | 
| payment_Id* | Идентификатор внешней операции | 
| fiscalreceipt_Id* | Идентификатор чека | 
| status* | Статус чека | 
| fiscal_receipt_number* | Номер чека в смене | 
| shift_number* | Номер смены | 
| receipt_datetime* | Дата и время документа из ФН | 
| total* | Итоговая сумма документа | 
| fn_number | Номер ФН | 
| ecr_registration_number* | Регистрационный номер ККМ | 
| fiscal_document_number* | Фискальный номер документа | 
| fiscal_document_attribute* | Фискальный признак документа | 
| errortext* | Текст ошибки | 
| taxationsystem* | Код системы налогообложения | 
| chequeItems** | Строка с позициями чека в JSON формате согласно документу «Работа с чеком». | 
*Параметры фискализации, передаются только при включенной настройке «Отправка результатов фискализации» в ЛК АПК Ассист.
** Позиции заказа, передаются только при включенной настройке «Отправлять позиции заказа» в ЛК АПК Ассист.
| Expand | ||
|---|---|---|
| 
 | ||
| передается дополнительный параметр в формате SOAP EXT 
 | 
В ответ на сообщение о результатах платежа система ожидает от магазина xml пакет.
Пример пакета в случае успешного получения и расшифровки сообщения о результате платежа:
| Code Block | ||
|---|---|---|
| 
 | ||
| <?xml version="1.0" encoding="UTF-8"?> 
<pushpaymentresult firstcode="0" secondcode="0">
 <order>
  <billnumber>value</billnumber>
  <packetdate>value</packetdate>                 
 </order>
</pushpaymentresult> | 
В случае неудачи:
| Code Block | ||
|---|---|---|
| 
 | ||
| <?xml version="1.0" encoding="UTF-8"?> 
<pushpaymentresult firstcode="value" secondcode="value">
</pushpaymentresult> | 
С описанием первого и второго кодов автоматизированных интерфейсов можно ознакомиться в Таблице "Коды автоматизированных интерфейсов".
Если от предприятия нет ответа ни об успешной, ни о неуспешной обработке сообщения о результате платежа, система будет повторять отправку сообщения с результатами платежа с увеличивающимся интервалом в течение четырех часов, но не более 8 раз.
| Warning | 
|---|
| Внимание! При получении ответа, указывающего на ошибки обработки сообщения с результатами платежа, повторная отправка результатов не производится. Указанные в ответе коды firstcode, secondcode используются для диагностики возникших проблем. | 
| Warning | 
|---|
| Внимание! В полученном ответе необходимо проверить значение параметра testmode. Если платеж был выполнен в тестовом режиме (testmode=1), то отгружать товар или оказывать услугу по текущему заказу не требуется. | 
Пример пакета результата в формате SOAP:
| Code Block | ||
|---|---|---|
| 
 | ||
| <?xml version="1.0" encoding="utf-8"?><soapenv:Envelope
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:ws="http://www.paysecure.ru/ws/"><soapenv:Body>
<ws:PushPaymentResult>
<merchant_id>500001</merchant_id>
<ordernumber>18062012_SDR</ordernumber>
<billnumber>550000110000001.1</billnumber>
<testmode>1</testmode>
<ordercomment>тестовый платеж</ordercomment> 
<orderamount>21.00</orderamount> 
<ordercurrency>RUB</ordercurrency>
<amount>21.00</amount> 
<currency>RUB</currency> 
<rate>1</rate> 
<firstname>Test</firstname> 
<lastname>Testov</lastname> 
<middlename>T.</middlename> 
<email>test@test.ru</email> 
<clientip>10.10.10.10</clientip> 
<ipaddress>0.0.0.0</ipaddress> 
<meantype_id>2</meantype_id> 
<meantypename>MasterCard</meantypename>
<meansubtype>Standart</meansubtype>
<meannumber>546792****4128</meannumber>
<cardholder>TEST</cardholder> 
<cardexpirationdate>12/20</cardexpirationdate>
<issuebank>Bank</issuebank> 
<bankcountry>RUS</bankcountry> 
<orderdate>18.06.2018 11:10:06</orderdate> 
<orderstate>Approved</orderstate> 
<responsecode>AS000</responsecode>
<message /> 
<customermessage>Завершено успешно.</customermessage>
<recommendation>SUCCESSFUL AUTHORIZATION</recommendation> 
<approvalcode>X40334</approvalcode>
<protocoltypename>NET</protocoltypename>
<processingname>Fake</processingname>
<operationtype>100</operationtype>
<operationdate>18.06.2018 11:10:07</operationdate> 
<authresult /> 
<authrequired>0</authrequired> 
<slipno>0363521111X31457</slipno>
<packetdate>18.06.2018 11:11:02</packetdate> 
<signature /> 
<checkvalue>45A33F800F2BD16C02E3D2F5C81557A0</checkvalue>
</ws: PushPaymentResul></soapenv:Body></soapenv:Envelope> | 
| Multiexcerpt include | ||||
|---|---|---|---|---|
| 
 | 
| extrrn*** | Уникальный номер платежа в процессинге | 
| Параметры 3DSecure | |
| version | Версия протокола 3DSecure | 
| alphaauthresult | Результат авторизации (Y - успешно, N - неуспешно, A - Attempt, U – невозможно провести аутентификацию, R- отказ, C – не завершено по каким-либо причинам, E - ошибка, I - для информации, S - без аутентификации с учетом низкой оценки риска) | 
| challenge | Взаимодействие с держателем карты (C – было, F – не было. D - отложенная аутентификация) | 
| eci | ElectronicCommerceIndicator (5 – полная аутентификация, 6 – попытка аутентификации, 7 – без аутентификации) | 
*Параметры фискализации, передаются только при включенной настройке «Отправка результатов фискализации» в ЛК АПК Ассист.
** Позиции заказа, передаются только при включенной настройке «Отправлять позиции заказа» в ЛК АПК Ассист.
***Для передачи параметра необходимо обратиться в службу поддержки (support@assist.ru).
| Expand | ||
|---|---|---|
| 
 | ||
| передается дополнительный параметр в формате SOAP EXT 
 | 
| Expand | |||||
|---|---|---|---|---|---|
| 
 | |||||
| 
 | 
| Expand | |||||
|---|---|---|---|---|---|
| 
 | |||||
| 
 | 
| Expand | |||||
|---|---|---|---|---|---|
| 
 | |||||
| 
 | |||||
| Expand | |||||
| 
 | |||||
| 
 | 
Если настройка ожидаемого ответа отлична от HTTP 200, то в ответ на сообщение о результатах платежа система ожидает от магазина xml пакет.
Ответ должен формироваться в зависимости от установленной настройки Тип протокола для выдачи результата в разделе ЛК Настройки отправки результатов платежей.
Для типа протокола POST
Пример пакета в случае успешного получения и расшифровки сообщения о результате платежа:
| Code Block | ||
|---|---|---|
| 
 | ||
| <?xml version="1.0" encoding="UTF-8"?> 
<pushpaymentresult firstcode="0" secondcode="0">
  <order>
    <billnumber>value</billnumber>
    <packetdate>value</packetdate>        
  </order>
</pushpaymentresult> | 
В случае неудачи:
| Code Block | ||
|---|---|---|
| 
 | ||
| <?xml version="1.0" encoding="UTF-8"?> 
<pushpaymentresult firstcode="value" secondcode="value">
</pushpaymentresult> | 
Для типа протокола SOAP
Пример пакета в случае успешного получения и расшифровки сообщения о результате платежа:
| Code Block | ||
|---|---|---|
| 
 | ||
| <SOAP-ENV:Envelope xmlns:SOAP-ENV="http://schemas.xmlsoap.org/soap/envelope/" xmlns:SOAP-ENC="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>
  <m:PushPaymentResultResponse xmlns:m="http://www.assist.ru/wsdl">
  <return xmlns:si="http://www.assist.ru/type/" xsi:type="si:SOAPStruct">
    <billnumber>5696145241469255.1</billnumber>
    <packetdate>26.06.2019 08:44:00</packetdate>
  </return>
  </m:PushPaymentResultResponse>
  </SOAP-ENV:Body>
</SOAP-ENV:Envelope> | 
В случае неудачи:
| Code Block | ||
|---|---|---|
| 
 | ||
| <?xml version="1.0" encoding="windows-1251"?>
    <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/">
            <SOAP-ENV:Fault>
                <faultcode>5</faultcode>
                <faultstring>143</faultstring>
                <detail />
            </SOAP-ENV:Fault>
        </SOAP-ENV:Body>
    </SOAP-ENV:Envelope> | 
С описанием первого и второго кодов ошибок можно ознакомиться в Таблице "Коды ошибок"
Система будет повторять отправку сообщения с результатами платежа с увеличивающимся интервалом в течение четырех часов, но не более 8 раз, если:
- настройка ожидаемого ответа отлична от HTTP 200, и от предприятия нет ответа ни об успешной, ни о неуспешной обработке сообщения о результате платежа;
- настройка ожидаемого ответа соответствует HTTP 200, но в ответе получено другое значение.
| Warning | 
|---|
| Внимание! При получении ответа, указывающего на ошибки обработки сообщения с результатами платежа, повторная отправка результатов не производится. Указанные в ответе коды firstcode, secondcode используются для диагностики возникших проблем. | 
| Warning | 
|---|
| Внимание! В полученном ответе необходимо проверить значение параметра testmode. Если платеж был выполнен в тестовом режиме (testmode=1), то отгружать товар или оказывать услугу по текущему заказу не требуется. | 
| Multiexcerpt include | ||||
|---|---|---|---|---|
| 
 | 
