Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

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


Окно создания счета

Параметры создания нового счета

...

Выбор пункта «Просмотр счета» в контекстном меню таблицы счетов вызывает открытие нового окна «Детализация счета» для просмотра параметров счета. Здесь также можно отредактировать параметры выставленного счета. Работа в этом окне осуществляется аналогично действиям в окне «Создание счета».


Форма просмотра (детализации) счета

Warning

Внимание! Если у предприятия настроен шаблон уведомления покупателю о выставлении счета для оплаты в системе ЕРИП (см. пример), то покупатель сможет оплатить счет в течение указанного срока с использованием ЕРИП. Если же предприятие использует стандартный шаблон уведомления, то покупатель получит ссылку для оплаты счета с помощью не только ЕРИП, но и других средств оплаты. При этом на оплату с помощью ЕРИП отводится не более 48 часов. К такому же результату приведет передача покупателю ссылки по счету оператором каким-либо способом.

...

Дата окончания рекуррентных платежей. Параметр обязателен при RecurringIndicator = 1

Название

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

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

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

Описание

Merchant_ID

Да

Число


Идентификатор предприятия в системе АПК Ассист

OrderNumber

Да

128 символов


Номер заказа в системе расчетов предприятия.

Delay

Нет

0 – одностадийный механизм работы
1- двустадийный механизм

0

Признак авторизации банковской карты при двустадийном механизме работы

Language

Нет

RU - русский,

EN - английский

Язык юр.лица или предприятия

Язык авторизационных страниц

OrderComment

Нет

256 символов


Комментарий (текст из этого поля будет отображен плательщику при оплате).

OrderAmount

Да

Число, 15 цифр (разделители «.», «,»)


Сумма платежа в оригинальной валюте (например, 10.34)

OrderCurrency

Нет

3 символа

Валюта юр.лица или предприятия

Код валюты, в которой указана сумма платежа OrderAmount (коды валют см. в Таблице кодов валют)

Lastname

Да

30 символов


Фамилия покупателя

Firstname

Да

30 символов


Имя покупателя

Middlename

Нет

30 символов


Отчество покупателя

Email

Нет

128 символа


E-mail покупателя

Address

Нет

256 символов


Адрес покупателя

HomePhone

Нет

64 символа


Домашний телефон покупателя

WorkPhone

Нет

20 символов


Рабочий телефон покупателя

MobilePhone

Нет

20 символов


Мобильный телефон покупателя

Fax

Нет

20 символов


Факс покупателя

Country

Нет

3 символа


Код страны покупателя

State

Нет

3 символа


Код региона покупателя

City

Нет

30 символов


Город покупателя

Zip

Нет

25 символов


Индекс предприятия связи покупателя

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 или параметр отсутствует (и оплата по банковским картам доступна для предприятия).

ERIPPayment

Нет

1 – использовать оплату по ЕРИП,
0 – не использовать

1

Покупатель сможет сделать платеж по ЕРИП, если передано значение параметра 1 или параметр отсутствует (и оплата по ЕРИП доступна для предприятия).

MobiconPayment

Нет

1 – использовать платежную систему Mobicon,
0 – не использовать

1

Покупатель сможет сделать платеж с помощью платежной системы Mobicon, если передано значение параметра 1 или параметр отсутствует (и оплата по Mobicon доступна для предприятия)

GooglePayPayment

Нет

1; 0

0

Признак оплаты через Google Pay (=1)

ApplePayPayment

Нет

1; 0

0

Признак оплаты через Apple Pay (=1)

SamsungPayPayment

Нет

1; 0

0

Признак оплаты через Samsung Pay (=1)

Signature

Нет*

строка


Формируется строка, сшитая из следующих параметров заказа:

Merchant_ID;OrderNumber;OrderAmount;

OrderCurrency

разделенных точкой с запятой.

На базе этой строки алгоритмом MD5 формируется дайджест.  Дайджест подписывается закрытым RSA ключом мерчанта. Длина ключа - 1024. Полученная байтовая последовательность является подписью магазина. Подпись передается нам в виде дополнительного параметра, закодированного в виде строки BASE64.

Warning

Внимание! Параметр необходим для того, чтобы обезопасить передаваемые данные от возможности их подмены злоумышленниками. Следует также включить настройку проверки кода или подписи в ЛК.

 

Checkvalue

Нет*

строка


Контрольный код

Checkvalue

Нет

строка

Контрольный код

. Строка формируется по следующей формуле: uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – результат строковой склейки параметров merchant_id, ordernumber, orderamount, ordercurrency разделенных точкой с запятой, + -строковая склейка.

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

Warning

Внимание! Параметр необходим для того, чтобы обезопасить передаваемые данные от возможности их подмены злоумышленниками. Следует также включить настройку проверки кода или подписи в ЛК.

RecurringIndicator

Нет

1 –рекуррентный – рекуррентный платеж
0 - нерекуррентный платеж

0

Признак рекуррентного платежа

RecurringMinAmount

Нет/Да

Число, 15 цифр (разделители «.», «,»)


Минимальная сумма рекуррентных платежей.  Параметр обязателен при RecurringIndicator = 1

RecurringMaxAmount

Нет/Да

Число, 15 цифр
(разделители «.», «,»)


Максимальная сумма рекуррентных платежей. Параметр обязателен при RecurringIndicator=1

RecurringPeriod

Нет/Да

Число, 10 цифр


Периодичность рекуррентных платежей в днях. Параметр обязателен при RecurringIndicator=1

RecurringMaxDate

Нет/Да

Строковое представление даты в формате DD.MM.YYYY

RecurringMaxDate

Нет/Да

Строковое представление даты в формате DD.MM.YYYY


Дата окончания рекуррентных платежей. Параметр обязателен при RecurringIndicator = 1

Disable3DS

Нет

0 – проверять 3-D Secure согласно настройкам предприятия,
1 – проводить платеж без 3-D Secure.

0

Признак отключения 3-D Secure.

Note

Использование такого режима работы возможно по согласованию с Assist.  Для настройки необходимо обратиться в службу технической поддержки support@belassist.by

 

Warning

При использовании параметра его необходимо добавлять и в подпись заказа, которая формируется по определенным правилам.

*Для того, чтобы обезопасить передаваемые данные от возможности их подмены злоумышленниками, необходимо передать один из параметров (Signature или Checkvalue), также должна быть включена настройка проверки контрольного кода (или подписи) в ЛК.

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

...

Название

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

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

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

Описание

Merchant_ID

Да

Число


Идентификатор предприятия в системе АПК Ассист

OrderNumber

Да/Нет

30 символов


Номер заказа в системе расчетов предприятия.

OrderAmount

Да

Число, 15 цифр (разделители «.», «,»)


Сумма платежа в оригинальной валюте (например, 10.34)

OrderCurrency

НетДа

3 символа

Валюта юр.лица или предприятия

Код валюты, в которой указана сумма платежа OrderAmount (RUB, USD, EUR)

OrderComment

Нет

256 символов


Комментарий (текст из этого поля будет отображен плательщику при оплате).

Language

Нет

RU – русский
EN - английский

Язык юр.лица или предприятия

Язык авторизационных страниц

Lastname

Да

30 символов без цифр


Фамилия покупателя

Firstname

Да

30 символов без цифр


Имя покупателя

Middlename

Нет

30 символов без цифр


Отчество покупателя

Email

Да

128 символов


E-mail покупателя

Address

Нет

90 символов


Адрес покупателя в формате: ул. <30 символов>, д. <10 символов>, корп. <10 символов>, кв. <10 символов>

City

Нет

30 символа


Город покупателя

Signature*

Нет

строка


Формируется строка, сшитая из следующих параметров заказа:

Merchant_ID;OrderNumber;OrderAmount;OrderCurrency, разделенных точкой с запятой. На базе этой строки алгоритмом MD5 формируется дайджест.  Дайджест подписывается закрытым RSA ключом мерчанта. Длина ключа - 1024. Полученная байтовая последовательность является подписью магазина. Подпись передается нам в виде дополнительного параметра, закодированного в виде строки BASE64

Checkvalue*

Нет

строка


Контрольный код. Строка формируется по следующей формуле: uppercase(md5(uppercase(md5(SALT) + md5(Х)))), где SALT – секретное слово; Х – результат строковой склейки параметров merchant_id, ordernumber, orderamount, ordercurrency разделенных точкой с запятой, + -строковая склейка.

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

...

Code Block
languagexml
<FORM ACTION="https://SERVER-NAME/pay/silentpaymakeorder.cfm " method="POST">
<INPUT TYPE="hidden" NAME="Merchant_ID" VALUE="Ваш Merchant_ID">
<INPUT TYPE="hidden" NAME="OrderNumber" VALUE="011001-10">
<INPUT TYPE="hidden" NAME="OrderAmount" VALUE="22">
<INPUT TYPE="hidden" NAME="OrderCurrency" VALUE="BYN">
<INPUT TYPE="hidden" NAME="OrderComment" VALUE="оплата заказа 011001-10">
<INPUT TYPE="hidden" NAME="Language" VALUE="RU">
<INPUT TYPE="hidden" NAME="Lastname" VALUE="Фамилия покупателя">
<INPUT TYPE="hidden" NAME="Firstname" VALUE="Имя покупателя">
<INPUT TYPE="hidden" NAME="Middlename" VALUE="Отчество покупателя">
<INPUT TYPE="hidden" NAME="Email" VALUE="Email покупателя">
<INPUT TYPE="hidden" NAME="Address" VALUE="Адрес покупателя ">
<INPUT TYPE="hidden" NAME="Homephone" VALUE="Домашний телефон покупателя">
<INPUT TYPE="hidden" NAME="City" VALUE="Город">
<INPUT TYPE="Submit"></FORM>

...

Code Block
languagetext
MERCHANT_ID;PERSONALACCOUNT;DEBT;SURNAME;FIRSTNAME;EMAIL;INFOLINE
500069;DFG4567;100.01;Testov;Test;test@assist.ruby;договор 454566

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

...

Code Block
languagexml
{{
"status":"Ok",
"amount" :
{"editable": true, "arrears": 100.00, "min": 1.00, "max":100.00}

,
"accountInfo" :
{"fName" : "Имя","lName": "Фамилия","mName": "Отчество"}

,
"addressInfo" :
{"city": "Город","street": "Улица","house": 8,"building":"2","apartment":"34"}
}}

...