Page History

...

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

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

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

...

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

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

...

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

Пример кнопки, содержащей оптимальный набор параметров:

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

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

Пример кнопки, содержащей оптимальный набор параметров:

<FORM ACTION="https://<SERVER-NAME>/pay/order.cfm"METHOD="POST

<FORM ACTION="https://<SERVER-NAME>/pay/order.cfm"METHOD="POST">
<INPUT TYPE="HIDDEN" NAME="Merchant_ID" VALUE="Ваш Merchant_ID">
<INPUT TYPE="HIDDEN" NAME="OrderNumberMerchant_ID" VALUE="Ваш Merchant_ID">
<INPUT TYPE="HIDDEN" NAME="OrderNumber" VALUE="A20042011_28">
<INPUT TYPE="HIDDEN" NAME="OrderAmount" VALUE="237.40">
<INPUT TYPE="HIDDEN" NAME="OrderCurrency" VALUE="USD">
<INPUT TYPE="HIDDEN" NAME="Delay"VALUE="0">
<INPUT TYPE="HIDDEN" NAME="Language"VALUE="RU">
<INPUT TYPE="HIDDEN" NAME="Email"VALUE="test@test.by">
<INPUT TYPE="HIDDEN" NAME="OrderComment" VALUE="Оплата заказа 28-A">
<INPUT TYPE="HIDDEN" NAME="URL_RETURN_OK" VALUE="http://www.URL.by/yes">
<INPUT TYPE="HIDDEN" NAME="URL_RETURN_NO" VALUE="http://www.URL.by/no">
<INPUT TYPE="HIDDEN" NAME="ERIPPayment"VALUE="1">
<INPUT TYPE="SUBMIT" NAME="Submit"VALUE="Купить">
</FORM>

...

...

<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>

...

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

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

...

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

Подготовленный файл с реестром можно загрузить в разделе «Абоненты» в Личном кабинете АПК Ассист.

...

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

Подготовленный файл с реестром можно загрузить в разделе «Абоненты» в Личном кабинете АПК Ассист.

Авансовые платежи с проверкой клиента на стороне предприятия

Предприятие может организовать пополнение личного кошелька клиента через ЕРИП. Средства кошелька клиент предприятия сможет использовать для последующей оплаты заказа. Для идентификации клиента возможно использование номера телефона, адреса Email или другого ID клиента. Верификация производится по заранее оговоренному ID (клиент должен знать, что именно требуется применять в качестве ID на стороне ЕРИП для начала пополнения своего кошелька).

Оплата осуществляется по следующему сценарию:

• клиент находит предприятие в каталоге ЕРИП и указывает свой ID;
• ЕРИП отправляет в АПК Ассист запрос с указанным клиентом ID;
• АПК Ассист посылает запрос предприятию о том, есть ли у него клиент с таким ID. Если клиент есть, то АПК Ассист отвечает в ЕРИП успехом, если нет - сообщает об ошибке Абонент не найден;
• клиент указывает сумму для пополнения кошелька и начинает процесс оплаты через ЕРИП;
• ЕРИП посылает в АПК Ассист запрос, далее оплата проводится по существующему сценарию авансового платежа (номер заказа формируется автоматически), таблица абонентов не используется при наличии верификации от предприятия;
• после проведения оплаты через ЕРИП АПК Ассист отправляет результат авторизации на сервер предприятия с идентификатором абонента и суммой зачисления, указанный в результате номер заказа/операции позволяет исключить дубли на стороне предприятия.

Для обеспечения проверки клиента на стороне предприятия должен быть реализован следующий сервис верификации:

Параметры запроса

Ответ сервера предприятия

• HTTP 200 в случае успешной обработки запроса. Ответ должен содержать следующие поля:

• HTTP 400 в случае неверных входных параметров. Ответ содержит следующие поля:

status - string: "Error"

errorMessage - string: текст описания ошибки

• HTTP 401 Unauthorized request (не прошла авторизация):

status - string: "Error"

errorMessage - string: текст описания ошибки

• HTTP 403 в случае проблем с выполнение запроса. Ответ содержит следующие поля:

status - string: "Error"

errorMessage - string: текст описания ошибки

Пример запроса к веб-сервису:

{"account":"TEST400_1","login":"test","password":"test1","amount":0}

Пример успешного ответа:

{{
"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"}
}}

Пример ответа с ошибкой:

{"status":"Error","errorMessage":"текст описания ошибки 400"}

Пример ответа в случае отсутствия лицевого счета:

{"status":"NotFound","errorMessage":"account не найден"}

Оповещения о платежах

Для оповещения предприятия о результате платежа в режиме реального времени система АПК Ассист предоставляет сервис синхронной отправки результатов платежа на сервер предприятия. После завершения покупателем оплаты заказа (при помощи банковской карты или одного из средств электронной наличности) на сервер предприятия методом HTTP POST или SOAP отправляется сообщение с параметрами платежа.

...

После активации и настройки сервиса на сервер предприятия будут отправляться результаты операций (оплат, подтверждений, отмен – в зависимости от настроек). Не отправляются результаты операций оплаты, завершенных по тайм-ауту.

В отправляемых с помощью сервиса результатах операций для авансовых платежей добавляется параметр personalaccount (по запросу в службу поддержки support@belassist.by) для того, чтобы предприятие могло определить, в адрес какого лицевого счета произведена оплата.

Подробнее о об отправке результатов платежей на сервер предприятия в соответствующем разделе документации.

...