Page History
...
Название | Обязательное поле | Принимаемые значения | Значение по умолчанию | Описание | ||||
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 символов | Определяется настройкой предприятия "Ставка налога по умолчанию" и используется в режиме без передачи позиций чека (вся сумма должна проводится с одной ставкой). | |||||
ReceiptLine* | Да/Нет4 | 128 символов | Определяется настройкой предприятия "Шаблон строки чека по умолчанию" и используется в режиме без передачи позиций чека). | Текстовое описание позиции чека, если по чеку проводится одна единственная позиция. | ||||
FPMode* | Да/Нет4 | Число | Определяется настройкой предприятия "Признак способа расчета по умолчанию" и используется в режиме без передачи позиций чека. | |||||
TaxationSystem** | Нет5 | Число | Из настроек предприятия или ККТ |
1 Номер счета может не передаваться, если включена автоматическая генерация номера счета.
2 Если не передано значение адреса E-mail, то отправка счета по E-mail невозможна. Если не передан номер телефона, то отправка SMS невозможна. Примечание. Если признак отправки равен 3, то при отсутствии номера телефона ссылка на счет будет отправлена только по E-mail, а при отсутствии адреса E-mail нотификация вообще не будет выполнена.
3 Контрольная сумма формируется на основе формулы:
uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – результат строковой склейки всех переданных параметров счета (в последовательности по порядку следования параметров в таблице сверху вниз, не включая DelayPayment, SendNotification, Checkvalue и CustomerNumber) через разделитель - точка с запятой(";"), '+' – строковая склейка.".
4 Состав чека (поля с названием, стоимостью за единицу товара/услуги, ставкой налога и способом расчета по каждой позиции) определяется по следующим правилам.
- Если в запросе передана структура ChequeItems (см. раздел «Работа с чеком»), то формируется чек с количеством позиций по числу переданных в ChequeItems строк, в каждой позиции должны быть обязательно указаны параметры:
- product и/или name;
- price;
- quantity;
- amount;
при этом:
название каждой из позиций формируется как объединение параметров product и name через пробел (если переданы оба) или как один из параметров product или name соответственно (если передан только один);
если параметры Tax или FPmode не переданы в позициях, то они могут быть переданы в параметрах запроса (в этом случае значения этих параметров будут одинаковыми для всех позиций чека, переданных в ChequeItems);
если параметры Tax или FPmode не переданы в параметрах запроса, то их значения подставляются из настроек предприятия (значения этих параметров будут одинаковыми для всех позиций чека, переданных в ChequeItems);
если настройки предприятия для этих параметров отсутствуют, то обработка запроса завершается с ошибкой (недостаточно данных для выполнения операции).
2. Если в запросе не передана структура ChequeItems, то формируется чек с одной позицией, в которой:
- название позиции подставляется из параметра ReceiptLine, если он передан в запросе; если параметр ReceiptLine не передан в запросе, то название позиции подставляется из настроек предприятия; если настройки предприятия для этих параметров отсутствуют, то в качестве названия подставляется строка "Оплата заказа";
- стоимость единицы товара/услуги подставляется из параметра запроса Amount;
- количество всегда равно 1;
если параметры Tax или FPmode не переданы в параметрах запроса, то их значения подставляются из настроек предприятия;
если настройки предприятия для этих параметров отсутствуют, то обработка запроса завершается с ошибкой (недостаточно данных для выполнения операции).
...
1 Номер счета может не передаваться, если включена автоматическая генерация номера счета.
2 Если не передано значение адреса E-mail, то отправка счета по E-mail невозможна. Если не передан номер телефона, то отправка SMS невозможна. Примечание. Если признак отправки равен 3, то при отсутствии номера телефона ссылка на счет будет отправлена только по E-mail, а при отсутствии адреса E-mail нотификация вообще не будет выполнена.
3 Контрольная сумма формируется на основе формулы:
uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – результат строковой склейки всех переданных параметров счета (в последовательности по порядку следования параметров в таблице сверху вниз, не включая DelayPayment, SendNotification, Checkvalue и CustomerNumber) через разделитель - точка с запятой(";"), '+' – строковая склейка.".
| Note |
|---|
Для фискализации операции оплаты счета в запросе могут передаваться дополнительные параметры для формирования корректного чека. Описание дополнительных параметров приведено в разделе "Режимы передачи данных чека" |
* параметры, необходимые при использовании сервиса фискализации АПК Ассист.
...
. |
Если счет или заказ с указанным в запросе номером уже существует, то счет не создается и выдается сообщение об ошибке "Счет с указанным номером уже существует".
...