Работа со счетами

Назначение и основные особенности счетов

Предприятие вызывает веб-сервис создания счета (с указанием номера счета, суммы, допустимого срока оплаты и т. д.), АПК Ассист формирует счет на оплату и платежный токен, соответствующий данному счету. Создание счета также возможно вручную из личного кабинета (https://account.paysecure.ru/). Ссылка с платежным токеном отправляется системой АПК Ассист покупателю по электронной почте или предприятие формирует URL с использованием полученного платежного токена и переадресовывает покупателя на страницу оплаты счета. Также предприятие самостоятельно может отправить ссылку покупателю с помощью E-mail, SMS или других средств связи. Ссылка на оплату счета имеет следующий вид: https://<SERVER_NAME>/bill/paybill.cfm?ID=c2RmZ2UzNXkyNXR5MjU0

Когда покупатель переходит по ссылке и соглашается оплатить счет, в системе АПК Ассист создается заказ. Далее покупатель вводит данные платежного средства и оплачивает заказ аналогично стандартному варианту подключения.

В данном разделе описывается процесс подключения сервисов выставления и оплаты счетов для предприятия, а также освещаются вопросы настройки технического взаимодействия с этими сервисами АПК Ассист.

Порядок действий предприятия при подключении сервисов выставления и оплаты счетов

сделать заявку для подключения к функционалу выставления и оплаты счетов в службу технической поддержки АПК Ассист support@assist.ru;

получить подтверждение от службы технической поддержки АПК Ассист о том, что все необходимые технические настройки для функционирования сервисов выставления и оплаты счетов при оплате товаров и услуг данному предприятию выполнены.

Cоздание счета (createbill)

Веб-сервис для создания счета принимает параметры счета в формате HTTP POST/SOAP либо JSON (swagger описание: https://docs.assist.ru/swagger/) и возвращает (в случае успешного создания счета) платежный токен/ID, соответствующий данному счету. На основе этого платежного токена предприятие может сформировать ссылку на своей стороне для переадресации покупателя на страницу оплаты счета или для самостоятельной отправки ее покупателю (E-mail, SMS или другие средства связи), или АПК Ассист может отправить ее по E-mail адресу покупателя, указанному в параметрах.

URL запроса для создания счета:

https://<SERVER-NAME>/bill/createbill.cfm

Список параметров запроса:

Название	Обязательное поле	Принимаемые значения	Значение по умолчанию	Описание
Merchant_ID	Да	Число		Идентификатор предприятия в АПК Ассист
Login	Да	8 - 20 символов		Логин (лат. буквы и цифры, символ _)
Password	Да	8 - 20 символов		Пароль (лат. буквы и цифры)
Bill	Да/Нет¹	128 символов		Номер счета (при создании заказа будет использован в качестве OrderNumber)
Bill_amount	Да	Число, 15 знаков, два знака после разделителя (допустимые разделители «.», «,»)		Сумма счета (OrderAmount в заказе)
Bill_currency	Да	3 символа		Валюта счета (OrderCurrency)
Bill_comment	Нет	256 символов		Комментарий (OrderComment в заказе)
Customer_Name	Нет	70 символов		Имя плательщика (FirstName в заказе)
Customer_Lastname	Нет	70 символов		Фамилия плательщика (LastName в заказе)
Customer_Middlename	Нет	70 символов		Отчество плательщика (MiddleName в заказе)
Customer_Email	Да/Нет²	128 символов		E-mail плательщика (Email в заказе)
Customer_Phone	Нет	20 символов		Телефон плательщика (HomePhone в заказе)
Customer_Mobile	Нет	20 символов		Мобильный телефон плательщика (MobilePhone в заказе)
Language	Нет	RU EN	Настройка базового языка аккаунта мерчанта	Язык платежных страниц
Pay_until	Нет	Дата/время	1 сутки	Крайний срок оплаты счета (дата и время в GMT): YYYYMMDDThhmm, если не передано - вычисляется на основе настройки мерчанта
DelayPayment	Нет	Число	0	Флаг двустадийного платежа (параметр delay в заказе): 0- одностадийный, 1 - двустадийный режим оплаты.
SendNotification	Нет	Число	В зависимости от настроек мерчанта	Признак отправки счета: 0 - не отправлять, 1 – отправлять ссылку по Email, 2 – отправлять ссылку в SMS, 3 – отправлять ссылку и по Emai, и в SMS.
URL_RETURN	Нет	255 символов		URL страницы, на которую должен вернуться покупатель после осуществления платежа в системе (должна быть активирована опция «Перейти на страницу магазина» в настройках мерчанта в Личном кабинете). В целях безопасности рекомендуется использовать протокол с шифрованием HTTPS.
URL_RETURN_OK	Нет	255 символов	Значение параметра URL_RETURN, а при его отсутствии – URL для возврата при успешной авторизации, указанный в Личном кабинете	URL страницы, куда должен вернуться покупатель после успешного осуществления платежа в системе АПК Ассист (должна быть активирована опция «Перейти на страницу магазина» в настройках мерчанта в Личном кабинете). В целях безопасности рекомендуется использовать протокол с шифрованием HTTPS.
URL_RETURN_NO	Нет	255 символов	Значение параметра URL_RETURN, а при его отсутствии – URL для возврата, указанный в Личном кабинете	URL страницы, куда должен вернуться покупатель после неуспешного осуществления платежа в системе АПК Ассист или при отсутствии ответа об окончательном статусе платежа (текущий статус "В процессе"), подробнее см. "Возврат покупателя на страницу интернет-магазина после покупки". Должна быть активирована опция «Возвращаться в магазин по URL для возврата» в Личном кабинете. В целях безопасности рекомендуется использовать протокол с шифрованием HTTPS.
CardPayment	Нет	1 – использовать оплату по банковской карте, 0 – не использовать	1	Покупатель сможет сделать платеж с помощью банковской карты, если передано значение параметра 1 или параметр отсутствует (и оплата по банковским картам доступна для предприятия).
YMPayment	Нет	1 – использовать платежную систему YandexMoney, 0 – не использовать	1	Покупатель сможет сделать платеж с помощью платежной системы YandexMoney, если передано значение параметра 1 или параметр отсутствует (и оплата по YandexMoney доступна для предприятия).
WMPayment	Нет	1 – использовать платежную систему WebMoney, 0 – не использовать	1	Покупатель сможет сделать платеж с помощью платежной системы WebMoney, если передано значение параметра 1 или параметр отсутствует (и оплата по WebMoney доступна для предприятия).
QIWIPayment	Нет	1 – использовать платежную систему QIWI, 0 – не использовать	1	Покупатель сможет сделать платеж с помощью всех средств оплаты платежной системы QIWI, если передано значение параметра 1 или параметр отсутствует (и оплата по QIWI доступна для предприятия)
FastPayPayment	Нет	1; 0	1	Покупатель сможет сделать платеж с помощью Системы Быстрых Платежей, если передано значение параметра 1 и оплата по СБП доступна для предприятия.
GooglePayPayment	Нет	1; 0	1	Признак оплаты через Google Pay (=1)
ApplePayPayment	Нет	1; 0	1	Признак оплаты через Apple Pay (=1)
SamsungPayPayment	Нет	1; 0	1	Признак оплаты через Samsung Pay (=1)
MirPayPayment	Нет	1; 0	1	Признак оплаты через Mir Pay (=1)
Checkvalue	Да/Нет	Строка		Контрольная сумма³
CustomerNumber	Нет	Строка		Идентификационный номер клиента магазина (для организации платежей в режиме OneClick).

¹ Номер счета может не передаваться, если включена автоматическая генерация номера счета.

² Если не передано значение адреса E-mail, то отправка счета по E-mail невозможна. Если не передан номер телефона, то отправка SMS невозможна. Примечание. Если признак отправки равен 3, то при отсутствии номера телефона ссылка на счет будет отправлена только по E-mail, а при отсутствии адреса E-mail нотификация вообще не будет выполнена.

³ Контрольная сумма формируется на основе формулы:

uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – результат строковой склейки всех переданных параметров счета (в последовательности по порядку следования параметров в таблице сверху вниз, не включая DelayPayment, SendNotification, Checkvalue и CustomerNumber) через разделитель - точка с запятой (";"), + – строковая склейка.

По умолчанию параметр не является обязательным. Если в целях безопасности предприятию необходимо использовать контрольную сумму, то для выполнения соответствующих настроек следует обратиться в службу технической поддержки АПК Ассист.

Для фискализации последующей операции оплаты счета в запросе на его создание заранее могут передаваться дополнительные параметры для формирования корректного чека. Описание дополнительных параметров приведено в разделе "Режимы передачи данных чека".

Если счет или заказ с указанным в запросе номером уже существует, то счет не создается и выдается сообщение об ошибке "Счет с указанным номером уже существует".

Если в запросе не переданы обязательные параметры или нарушены форматы передачи данных, то счет не создается и выдается сообщение об ошибке (аналогично ошибке при создании заказа с неверными/недостающими параметрами).

Если не удается создать уникальный платежный токен/ID, то счет не создается и выдается сообщение об ошибке "Не удалось сформировать уникальный платежный токен".

Информация об использовании протокола 3-D Secure 2.0 при создании платежа.

Пример запроса HTTP POST для создания счета:

<FORM ACTION="https://<SERVER-NAME>/bill/createbill.cfm" method="POST">
<INPUT TYPE="hidden" NAME="Merchant_ID" VALUE="Ваш Merchant_ID">
<INPUT TYPE="hidden" NAME="Login" VALUE="Ваш логин">
<INPUT TYPE="hidden" NAME="Password" VALUE="Ваш пароль">
<INPUT TYPE="hidden" NAME="Bill" VALUE="Номер счета">
<INPUT TYPE="hidden" NAME="Bill_amount" VALUE="Сумма счета">
<INPUT TYPE="hidden" NAME="Bill_currency" VALUE="Валюта счета">
<INPUT TYPE="hidden" NAME="Bill_comment" VALUE="Комментарий к счету">
<INPUT TYPE="hidden" NAME="Customer_Name" VALUE="Имя плательщика">
<INPUT TYPE="hidden" NAME="Customer_Lastname" VALUE="Фамилия плательщика">
<INPUT TYPE="hidden" NAME="Customer_Middleтame" VALUE="Отчество плательщика">
<INPUT TYPE="hidden" NAME="Customer_Email" VALUE="Email плательщика">
<INPUT TYPE="hidden" NAME="Customer_Phone" VALUE="Телефон плательщика">
<INPUT TYPE="hidden" NAME="Customer_Mobile" VALUE="Моб. телефон плательщика">
<INPUT TYPE="hidden" NAME="Language" VALUE="Язык платежных страниц">
<INPUT TYPE="hidden" NAME="Pay_until" VALUE="Срок оплаты счета">
<INPUT TYPE="hidden" NAME="SendNotification" VALUE="Флаг отправки счета">
<INPUT TYPE="hidden" NAME="Checkvalue" VALUE="Контрольная сумма">
<INPUT TYPE="hidden" NAME="GenerateReceipt" VALUE="1">
<INPUT TYPE="hidden" NAME="Tax" VALUE="Идентификатор ставки налога">
<INPUT TYPE="hidden" NAME="ReceiptLine" VALUE="Наименование позиции чека">
<INPUT TYPE="hidden" NAME="FPMode" VALUE="Признак способа расчета">
<INPUT TYPE="Submit"></FORM>

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

Название	Значение
Hash	Платежный токен/ID счета

Пример результата запроса для создания счета в формате CSV:

Hash: xKPWpz4ZzDe5A9anPhnN

В формате XML:

<?xml version='1.0' encoding='utf-8' standalone='yes'?>
<result 
   firstcode="0"
   secondcode="0" 
   count="1">
      <return>
          <Hash>akPWp08t84MTQ9anTy30</Hash>
      </return>
</result>

Описание веб-сервиса для формата SOAP:

https://<SERVER_NAME>/bill/createbill.wsdl

Пример запроса для создания счета:

<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header/>
    <Body>
        <CreateBill>
            <Bill>
                <merchant_id>423422</merchant_id>
                <login>login</login>
                <password>password</password>
                <bill>123456</bill>
                <bill_amount>23.23</bill_amount>
                <bill_currency>RUB</bill_currency>
                <bill_comment></bill_comment>
                <customer_name>Test</customer_name>
                <customer_lastname>Testov</customer_lastname>
                <customer_middlename>Testovich</customer_middlename>
                <customer_email>test@testpost.ru</customer_email>
                <customer_phone></customer_phone>
                <language>RU</language>
                <pay_until>20150611T1212</pay_until>
                <sendnotification>0</sendnotification>
                <checkvalue> AA3BC3F48B7FE23988044B53AA98F169</checkvalue>
            </Bill>
        </CreateBill>
    </Body>
</Envelope>

Пример результата запроса создания счета:

<soapenv:Envelope 
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
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:BillResponse xmlns:ASS-NS="http://www.paysecure.ru/ws/">
            <return xsi:type="si:SOAPStruct" xmlns:si="http://www.paysecure.ru/type/">
                <Hash xsi:type="xsd:string">6CPV7F4a0aWQg9XsXhrS</Hash>
            </return>
        </ASS-NS:BillResponse>
    </SOAP-ENV:Body>

Запрос статуса счета (billstatus)

Сервис позволяет получить полные данные о счете, его оплате и отменам по его номеру или параметру billnumber.

Если счет не удалось найти по его номеру, выдается сообщение об ошибке "Счет не найден".

Если заказ не удалось найти по параметру billnumber, то выдается сообщение об ошибке "Счет не найден среди обработанных".

URL запроса статуса счета:

https://<SERVER-NAME>/bill/billstatus.cfm

Список параметров запроса:

Название	Обязательное поле	Принимаемые значения	Значение по умолчанию	Описание
Merchant_ID	Да	Число		Идентификатор предприятия в АПК Ассист
Login	Да	8 - 20 символов		Логин (лат. буквы и цифры, символ _)
Password	Да	8 - 20 символов		Пароль (лат. буквы и цифры)
Bill	Да/Нет^*	128 символов		Номер счета (при создании заказа будет использован в качестве OrderNumber)
BillNumber	Да/Нет^*	15 или 16 цифр		Номер платежа - уникальный номер заказа в системе АПК Ассист

^*Обязательно должен быть передан один из параметров - Bill или BillNumber. Если в одном запросе переданы оба параметра, то поиск будет осуществляться по BillNumber.

Пример запроса HTTP POST для получения статуса счета:

<FORM ACTION="https://<SERVER-NAME>/bill/billstatus.cfm" method="POST">
<INPUT TYPE="hidden" NAME="Merchant_ID" VALUE="Ваш Merchant_ID">
<INPUT TYPE="hidden" NAME="Login" VALUE="Ваш логин">
<INPUT TYPE="hidden" NAME="Password" VALUE="Ваш пароль">
<INPUT TYPE="hidden" NAME="Bill" VALUE="Номер счета">
<INPUT TYPE="hidden" NAME="BillNumber" VALUE="Номер платежа">
<INPUT TYPE="Submit"></FORM>

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

Название	Значение
Merchant_id	Идентификатор предприятия
Bill	Номер счета
Bill_amount	Сумма счета
Bill_currency	Валюта счета
Bill_comment	Комментарий к счету
Bill_date	Дата и время создания счета (GMT)
Bill_status	Статус счета
Billnumber	Номер платежа (пусто, если заказ не был создан) = Billnumber заказа
Payment_date	Дата и время оплаты счета (пусто, если заказ не был создан) = OrderDate (GMT)
Payment_amount	Сумма платежа (пусто, если заказ не был создан) = сумма операции оплаты amount
Payment_currency	Валюта платежа (пусто, если заказ не был создан) = валюта операции оплаты currency
Payment_RRN	Дополнительный идентификатор платежа/RRN (пусто если не было оплаты)
Refund_amount	Сумма успешных возвратов по платежу (пусто, если заказ не был создан; 0, если оплата была, но не было возвратов)
Customer_name	Имя плательщика
Customer_Lastname	Фамилия плательщика
Customer_Middlename	Отчество плательщика
Customer_Email	Email плательщика
Customer_Phone	Телефон плательщика
Customer_Mobile	Мобильный телефон плательщика
Language	Язык
Pay_until	Срок оплаты счета (GMT)
Sendnotification	Флаг отправки счета (0 - не отправлять, 1 - отправлять, 10 – отправлен)*
Bill_type	Тип счета (1 - по умолчанию)
CheckValue	Контрольная сумма формируется на основе формулы: uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – результат строковой склейки всех переданных параметров ответа (в последовательности по порядку следования параметров в таблице сверху вниз, не включая SendNotification и Checkvalue) через разделитель - точка с запятой(";"), разделитель добавляется и в случае отсутствующего параметра, '+' – строковая склейка."

* Если при создании счета была запрошена отправка счета (с помощью передачи параметра SendNotification=1 или настроек в системе АПК Ассист), то после создания счета параметр SendNotification в ответе может иметь следующие значения:

1 - если отправка E-mail еще не состоялась (например, не указан адрес E-mail);
10 - если письмо уже было сформировано и отправлено (поставлено в очередь отправки).

Пример результата запроса статуса счета в формате CSV:

merchant_id:515089; bill:2015.06.30 11:19-85; bill_amount:100.00; bill_currency:RUB; bill_comment:; bill_date:30.06.2015 08:19:41; 
bill_status:Invoiced; billNumber:;payment_date: ; payment_amount:0.00; payment_currency:; payment_rrn:; refund_amount:; 
customer_name:Test; customer_lastname:Testov; customer_middlename:; customer_email:test@testpost.ru; customer_phone:; customer_mobile:; 
language:RU; pay_until:20150701T0819; sendnotification:1; checkValue:26397652E3DB8E25407A9B091B9431B3

В формате XML:

<?xml version='1.0' encoding='utf-8' standalone='yes'?>
<result firstcode="0" secondcode="0" count="1">
   <orders>
      <order>
          <merchant_id>515089</merchant_id>
          <bill>20150630111985</bill>
          <bill_amount>100.00</bill_amount>
          <bill_currency>RUB</bill_currency>
          <bill_comment/>
          <bill_date>30.06.2015 08:19:41</bill_date>
          <bill_status>Invoiced</bill_status>
          <billNumber/>
          <payment_date></payment_date>
          <payment_amount>0.00</payment_amount>
          <payment_currency/>
          <payment_rrn/>
          <refund_amount/>
          <customer_name>Test</customer_name>
          <customer_lastname>Testov</customer_lastname>
          <customer_middlename/>
          <customer_email>test@testpost.ru</customer_email>
          <customer_phone/>
          <customer_mobile/>
          <language>RU</language>
          <pay_until>20150701T0819</pay_until>
          <sendnotification>1</sendnotification>
          <checkValue>26397652E3DB8E25407A9B091B9431B3</checkValue>
      </order>
   </orders>
</result>

Описание веб-сервиса для формата SOAP:

https://<SERVER_NAME>/bill/billstatus.wsdl

Пример запроса статуса счета:

<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header/>
    <Body>
        <BillStatus>
            <Bill>
                <merchant_id>423422</merchant_id>
                <login>login</login>
                <password>password</password>
                <bill>123456</bill>
                <billnumber></billnumber>
            </Bill>
        </BillStatus>
    </Body>
</Envelope>

Пример результата запроса статуса счета:

<soapenv:Envelope 
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
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:BillResponse xmlns:ASS-NS="http://www.paysecure.ru/ws/">
            <return xsi:type="si:SOAPStruct" xmlns:si="http://www.paysecure.ru/type/">
                <merchant_idxsi:type="xsd:string">515089</merchant_id>
                <bill xsi:type="xsd:string">20150610115527</bill>
                <bill_amount xsi:type="xsd:string">150.00</bill_amount>
                <bill_currency xsi:type="xsd:string">RUB</bill_currency>
                <bill_comment xsi:type="xsd:string">testbill</bill_comment>
                <bill_date xsi:type="xsd:string">10.06.2015 09:03:07</bill_date>
                <bill_status xsi:type="xsd:string">Invoiced</bill_status>
                <billNumber xsi:type="xsd:string"/>
                <payment_date xsi:type="xsd:string"></payment_date>
                <payment_amount xsi:type="xsd:string">0.00</payment_amount>
                <payment_currency xsi:type="xsd:string"/>
                <payment_rrn xsi:type="xsd:string"/>
                <refund_amount xsi:type="xsd:string"/>
                <customer_name xsi:type="xsd:string">test</customer_name>
                <customer_lastname xsi:type="xsd:string">testov</customer_lastname>
                <customer_middlename xsi:type="xsd:string"/>
                <customer_email xsi:type="xsd:string">test@testpost.ru</customer_email>
                <customer_phone xsi:type="xsd:string"/>
                <customer_mobile xsi:type="xsd:string"/>
                <language xsi:type="xsd:string">EN</language>
                <pay_until xsi:type="xsd:string">20150611T0903</pay_until>
                <sendnotification xsi:type="xsd:string">0</sendnotification>
                <checkValue xsi:type="xsd:string">D9F0E4933007B96BCC2594983F7A24E3</checkValue>
            </return>
        </ASS-NS:BillResponse>
    </SOAP-ENV:Body>

Запрос аннулирования счета (billrevoke)

Сервис позволяет аннулировать еще не оплаченный счет. Вызов этого сервиса переводит счет в статус Deleted (удален), если счет на момент запроса находится в одном из статусов: Invoiced (выставлен) или Timed out (просрочен).

URL для аннулирования счета:

https://<SERVER-NAME>/bill/billrevoke.cfm

Список параметров запроса:

Название	Обязательное поле	Принимаемые значения	Значение по умолчанию	Описание
Merchant_ID	Да	Число		Идентификатор предприятия в АПК Ассист
Login	Да	8 - 20 символов		Логин (лат. буквы и цифры, символ _)
Password	Да	8 - 20 символов		Пароль (лат. буквы и цифры)
Bill	Да	128 символов		Номер счета
SendNotification	Нет	Число	В зависимости от настроек мерчанта	Флаг отправки уведомления об аннулировании счета (если параметр не передан в запросе, то используется настройка по умолчанию для данного мерчанта в системе АПК Ассист).
Checkvalue	Да	Строка		Контрольная сумма (формируется так же, как при создании счета по параметрам этой таблицы)

Пример запроса HTTP POST для аннулирования счета:

<FORM ACTION="https://test.paysecure.ru/bill/billrevoke.cfm" method="POST">
<INPUT TYPE="hidden" NAME="Merchant_ID" VALUE="Ваш Merchant_ID">
<INPUT TYPE="hidden" NAME="Login" VALUE="Ваш логин">
<INPUT TYPE="hidden" NAME="Password" VALUE="Ваш пароль">
<INPUT TYPE="hidden" NAME="Bill" VALUE="Номер счета">
<INPUT TYPE="hidden" NAME="SendNotification" VALUE="Флаг отправки счета">
<INPUT TYPE="hidden" NAME="Checkvalue" VALUE="Контрольная сумма">
<INPUT TYPE="Submit"></FORM>

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

Название	Значение
Bill	Номер счета
Bill_status	Статус счета

Пример результата запроса аннулирования счета в формате CSV:

bill:2015.06.30 11:17-81; bill_status:Revoked

В формате XML:

<?xml version='1.0' encoding='utf-8' standalone='yes'?>
<result firstcode="0" secondcode="0" count="1">
      <return>
          <bill>20150630111985</bill>
          <bill_status>Revoked</bill_status>
      </return>
</result>

Описание веб-сервиса для формата SOAP:

https://<SERVER_NAME>/bill/billrevoke.wsdl

Пример запроса аннулирования счета:

<?xml version="1.0" encoding="UTF-8"?>
<Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:xsd="http://www.w3.org/2001/XMLSchema"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Header/>
    <Body>
        <BillRevoke>
            <Bill>
                <merchant_id>423422</merchant_id>
                <login>login</login>
                <password>password</password>
                <bill>123456</bill>
                <sendnotification>0</sendnotification>
                <checkvalue> AA3BC3F48B7FE23988044B53AA98F169</checkvalue>
            </Bill>
        </BillRevoke>
    </Body>
</Envelope>

Пример результата запроса аннулирования счета:

<soapenv:Envelope 
SOAP-ENV:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/"
xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" 
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:BillResponse xmlns:ASS-NS="http://www.paysecure.ru/ws/">
            <return xsi:type="si:SOAPStruct" xmlns:si="http://www.paysecure.ru/type/">
                <bill xsi:type="xsd:string">20150610115527</bill>
                <bill_status xsi:type="xsd:string">Revoked</bill_status>
            </return>
        </ASS-NS:BillResponse>
    </SOAP-ENV:Body>

Шаблоны уведомлений

После выставления счета покупатель получит уведомление по электронной почте. Ниже представлен пример подобного уведомления:

Subj

Вам выставлен счет для оплаты

Text

Здравствуйте, Тестов Тест Тестович,

Сообщаем, что для вас был сформирован счет № 1c362fd на сумму 888.42 RUB

Вы можете оплатить его в срок до 25.01.2015 18:00 (MSK).

Для просмотра и оплаты счета перейдите по ссылке ниже.

https://payments.paysecure.ru/bill/paybill.cfm?ID=c2RmZ2UzNXkyNXR5MjU0

По всем вопросам, связанным этим счетом, пожалуйста, обращайтесь в интернет-магазин №1 по адресу: shop1@testpost.ru

_____________

С уважением,

Отдел технической поддержки

Assist

www.assist.ru

В случае аннулирования счета покупатель также получит уведомление по электронной почте. Ниже представлен его пример:

Subj

Счет был аннулирован

Text

Здравствуйте, Тестов Тест Тестович,

Сообщаем, что счет № 1c362fd на сумму 888.42 RUB был аннулирован.

По всем вопросам, связанным этим счетом, пожалуйста, обращайтесь в интернет-магазин №1 по адресу: shop1@testpost.ru

_____________

С уважением,

Отдел технической поддержки

Assist

www.assist.ru

В случае необходимости покупатель может создать свое обращение простым ответом на полученное уведомление. Если в качестве адреса для обращений покупателей при подключении к АПК Ассист предприятием было указано несколько адресов, то обращение будет отправлено по всем этим адресам.

Шаблоны уведомлений могут быть настроены по желанию предприятия. Для этого следует обратиться в службу технической поддержки АПК Ассист support@assist.ru.

Наверх

Content

Space Tools

Назначение и основные особенности счетов

Cоздание счета (createbill)

Запрос статуса счета (billstatus)

Запрос аннулирования счета (billrevoke)

Шаблоны уведомлений