Предприятие вызывает веб-сервис создания счета (с указанием номера счета, суммы, допустимого срока оплаты и т. д.), АПК Ассист формирует счет на оплату и платежный токен, соответствующий данному счету. Создание счета также возможно вручную из личного кабинета (https://account.paysecure.ru). Ссылка с платежным токеном отправляется системой АПК Ассист покупателю по электронной почте или предприятие формирует URL с использованием полученного платежного токена и переадресовывает покупателя на страницу оплаты счета. Также предприятие самостоятельная может отправить ссылку покупателю с помощью E-mail, SMS или других средств связи. Ссылка на оплату счета имеет следующий вид: https://<SERVER_NAME>/bill/paybill.cfm?ID=c2RmZ2UzNXkyNXR5MjU0
Когда покупатель переходит по ссылке и соглашается оплатить счет, в системе АПК Ассист создается заказ. Далее покупатель вводит данные платежного средства и оплачивает заказ аналогично стандартному варианту подключения.
В данном разделе описывается процесс подключения сервисов выставления и оплаты счетов для предприятия, а также освещаются вопросы настройки технического взаимодействия с этими сервисами АПК Ассист.
Порядок действий предприятия при подключении сервисов выставления и оплаты счетов
Веб-сервис для создания счета принимает параметры счета (форматы HTTP POST/SOAP) и возвращает (в случае успешного создания счета) платежный токен/ID, соответствующий данному счету. На основе этого платежного токена предприятие может сформировать ссылку на своей стороне для переадресации покупателя на страницу оплаты счета или для самостоятельной отправки ее покупателю (E-mail, SMS или другие средства связи), или АПК Ассист может отправить ее по E-mail адресу покупателя, указанному в параметрах.
URL запроса для создания счета:
https://<SERVER-NAME>/bill/createbill.cfm
Список параметров запроса:
Название | Обязатель-ное поле | Принимаемые значения | Значение по умолчанию | Описание |
Merchant_ID | Да | Число |
| Идентификатор предприятия в АПК Ассист |
Login | Да | 8 - 20 символов |
| Логин (лат. буквы и цифры, символ _) |
Password | Да | 8 - 20 символов |
| Пароль (лат. буквы и цифры) |
Bill | Да/Нет1 | Строка |
| Номер счета (при создании заказа будет использован в качестве OrderNumber) |
Bill_amount | Да | Число |
| Сумма счета (OrderAmount в заказе) |
Bill_currency | Да | Строка |
| Валюта счета (OrderCurrency) |
Bill_comment | Нет | Строка |
| Комментарий (OrderComment в заказе) |
Customer_Name | Нет | Строка |
| Имя плательщика (FirstName в заказе) |
Customer_Lastname | Нет | Строка |
| Фамилия плательщика (LastName в заказе) |
Customer_Middlename | Нет | Строка |
| Отчество плательщика (MiddleName в заказе) |
Customer_Email | Да/Нет2 | Строка |
| E-mail плательщика (Email в заказе) |
Customer_Phone | Нет | Строка |
| Телефон плательщика (HomePhone в заказе) |
Customer_Mobile | Нет | Строка |
| Мобильный телефон плательщика (MobilePhone в заказе) |
Language | Нет | RU EN | Настройка базового языка аккаунта мерчанта | Язык платежных страниц |
Pay_until | Нет | Дата/время | 1 сутки | Крайний срок оплаты счета (дата и время в GMT): YYYYMMDDThhmm, если не передано - вычисляется на основе настройки мерчанта |
DelayPayment | Нет | Число | 0 | Флаг двустадийного платежа (параметр delay в заказе): 0- одностадийный, 1 - двустадийный режим оплаты. |
SendNotification | Нет | Число | В зависимости от настроек мерчанта | Признак отправки счета: 0 - не отправлять, 1 – отправлять ссылку по Email, 2 – отправлять ссылку в SMS, 3 – отправлять ссылку и по Emai, и в SMS. |
Checkvalue | Да | Строка |
| Контрольная сумма3 |
CustomerNumber | Нет | Строка |
| Идентификационный номер клиента магазина (для организации платежей в режиме OneClick). |
Chequeitems** | Да/Нет4 | Структура данных (строка в формате JSON) |
| Позиции чека согласно документу «Работа с чеком». |
GenerateReceipt* | Нет | 0 или 1 | 1 | Разрешение формирования фискального чека. При значении параметра 0 формирование фискального чека запрещено для данного заказа. |
Tax* | Да/Нет4 | 10 символов | Определяется настройкой предприятия "Ставка налога по умолчанию" и используется в режиме без передачи позиций чека (вся сумма должна проводится с одной ставкой). | Идентификатор ставки налога, значение из справочника (novat, vat0, vat10, vat18, vat110, vat118). |
ReceiptLine* | Да/Нет4 | 128 символов | Определяется настройкой предприятия "Шаблон строки чека по умолчанию" и используется в режиме без передачи позиций чека). | Текстовое описание позиции чека, если по чеку проводится одна единственная позиция. |
FPMode* | Да/Нет4 | Число | Определяется настройкой предприятия "Признак способа расчета по умолчанию" и используется в режиме без передачи позиций чека. | Признак способа расчета (см. приложение). |
TaxationSystem** | Нет5 | Число | Из настроек предприятия или ККТ | Система налогообложения, см. Приложение |