Показать страницуСсылки сюдаНаверх Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно. ====== A-Bank ====== [[billing:preferences:payment_system:payment_system|Вернуться на уровень выше]] ===== Пример заявки на подключение провайдера ===== Сообщите менеджеру Server URL вида https://admin.ispnet.demo/ajax/index/abank **Алгоритм работы:** * предварительный поиск (Presearch) * поиск после предварительного поиска (Search после Presearch) * оплата услуг (Pay) Также, что Ваш **companyCode = 1** и **serviceCode = 101**. Для **предварительного поиска** (ПП) абонентов (по полям: **uid, login, номер договора**) использовать функцию **Presearch** и присылать параметр для поиска как **ls**. Т.е. запрос на ПП должен иметь вид: <code XML><?xml version="1.0" encoding="UTF8" standalone="yes"?> <Transfer xmlns="http://debt.privatbank.ua/Transfer" interface="Debt" action="Presearch"> <Data xmlns:xsi="http://www.w3.org/2001/XMLSchemainstance" xsi:type="Payer"> <Unit name="ls" value="testuser" /> </Data> </Transfer></code> После него выполняется "Поиск (Search) после ПП", в котором по идентификатору абонента (bill_identifier = uid) производится получение информации о нём и рекомендуемый платёж. В завершение происходит Оплата (метод Pay). Пояснения: <note important>"Server URL" Обязательно должен быть внешним доменом!</note> <note tip>Не забываем заменить "admin.ispnet.demo" на свой Внешний домен, который доступен из интернет или внешний IP на котором доступна "админка".</note> <note warning>http или https несущественно, главное чтобы по этой ссылке(https://admin.ispnet.demo) вы могли попадать в админку из интернета.</note> <note>В данный момент доступны для использования методы: Presearch, "Search после Presearch" и Pay.</note> <note important>Операции запроса "Check" и "Cancel" в данный момент не поддержаны.</note> ===== Примеры запросов/ответов ===== Методы SearchAfterPresearch и Search **Запрос:** <file> <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Transfer action="Search" interface="Debt" xmlns="http://debt.privatbank.ua/Transfer"> <Data xsi:type="Payer" presearchId="3" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"/> </Transfer> </file> **Ответ:** <file> <?xml version="1.0" encoding="UTF-8" standalone="yes"?> <Transfer xmlns="http://debt.privatbank.ua/Transfer" interface="Debt" action="Search"> <Data xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:type="DebtPack" > <DopData> <Dop name="login" value="office"/> <Dop name="uid" value="3"/> <Dop name="dogovor" value="12345"/> </DopData> <PayerInfo billIdentifier="3"> <Fio>Криворукий Степан Иванвич</Fio> <Address>Киев Гоголя 1</Address> </PayerInfo> <ServiceGroup> <DebtService serviceCode="101" > <CompanyInfo> <CompanyCode>1</CompanyCode> </CompanyInfo> <DebtInfo amountToPay="0" debt="-1210.81"/> <PayerInfo billIdentifier="3"> <Fio>Криворукий Степан Иванвич</Fio> </PayerInfo> </DebtService> </ServiceGroup> </Data> </Transfer> </file> <note tip>Существующие данные в ответе можно использовать для построения шаблонов </note> <note tip>Пример шаблона назначения платежа: "Оплата згідно договору NoXXXXX від Iванова Івана Івановича, UID=1234, login=XXXX" </note> ^Элемент^Атрибут^Описание^ |/Transfer/Data/DopData| |Дополнительные параметры абонента (uid, login, dogovor)| |/Transfer/Data/PayerInfo/Address| | Адрес| |/Transfer/Data/PayerInfo/Fio| |ФИО| |/Transfer/Data/ServiceGroup/DebtService/DebtInfo| amountToPay | Сумма к оплате | |/Transfer/Data/ServiceGroup/DebtService/DebtInfo| debt | Сумма задолженности. Отрицательное значение обозначает переплату, положительное — задолженность. | \\ <file> <DopData> <Dop name="login" value="office"/> <Dop name="uid" value="3"/> <Dop name="dogovor" value="12345"/> </DopData> </file> <file> <Fio>Криворукий Степан Иванвич</Fio> <Address>Киев Гоголя 1</Address> </file> <file> <DebtInfo amountToPay="0" debt="-1210.81"/> </file> ===== Услуги ===== При использовании "Предварительного Поиска" поиск абонента производится по **uid, login, номер договора**. Поиск и оплата происходит для основных групп пользователей: **обычный (базовый) и замороженный**. Если же сразу производить "Поиск", то однозначная идентификация абонента производится по полю uid. По запросу на поиск, будет возвращены Ф.И.О. пользователя в виде "Иванов Михаил Иванович" и сумма, рекомендуемая к оплате с учётом текущего депозита и индивидуальной скидки абонента. В зависимости от того в каком виде будет получен запрос, сервер MikBill автоматически его обработает, настроек не требует. ===== Настройка MikBill ===== Открываем "Настройки"->"Системные опции". Вкладка "Терминалы" {{:billing:preferences:payment_system:2020-11-26_16-26-59.png?400|}} <note tip>Не забываем отметить "Разрешить".</note> ^ Параметр ^ Пояснение ^ | Обязательные: || | подсеть | Подсеть, из которой разрешён доступ | |Название компании| ваше название компании| |МФО| мфо для р/с| |ОКПО| окпо для р/с| |Р/С|р/с компании| | Не обязательные: || | процент отчислений | Необходимо для отчетности | Так же выберете способы, какими Вы хотите, чтоб система искала абонентов: UID, login, номер договора. Будут использованы все выбранные Вами варианты. Всё, настройка закончена. ===== Как это работает ===== Провайдер имеет договор с A-Банк и расчетный счет. Клиент приходит в кассу и говорит кассиру "я хочу пополнить счет своего провайдера" (и называет его). Абонент называет свой **UID** или **ЛОГИН** или **НОМЕР ДОГОВОРА**. Кассир делает запрос в биллинг на поиск пользователя и сначала получает список "возможных" пользователей (например, если у Вас в системе могут совпадать UID одного абонента с логином другого). По ФИО абонента кассир уточняет, найден ли абонент правильно. Если всё верно, то делается запрос на уточнение состояния баланса абонента и сумму рекомендательного платежа. ===== Оплата на разные Р/С в А-Банк по признаку дилера у абонента ===== С версии 2.7.15 в MikBiLL появилась возможность выполнять перевод средств абонента при пополнении на различные Р/С исходя из свойств абонента, а именно того, кто является его дилером. Для этого Вам необходимо сначала в А-Банк установить, за какой ID отвечает какой Р/С. ID пользователя будет возвращено в атрибуте ''CompanyCode'': <code XML><ServiceGroup><DebtService serviceCode="101" ><CompanyInfo><ServiceGroup><DebtService serviceCode="101" > <CompanyCode>ID_ДИЛЕРА</CompanyCode> </CompanyInfo> </DebtService></ServiceGroup></code> , где ID_ДИЛЕРА и будет ID дилера, которому принадлежит абонент. Так же Вам необходимо в системных опциях включить свойство "Привязать к дилеру" в настройке "А-Банк". <note warning>Если у абонента не будет дилера, то будет возвращён в месте ID_ДИЛЕРА "0" - предусмотрите этот вариант за ранее, если считаете, что у Вас могут быть такие абоненты.</note> ===== Пример анкеты ===== <panel type="default" title="Анкета онлаин биллинг"> <TEXT align="center" type="danger"> Для заполнения анкеты сохраните пример на диск! \\ Заполненную анкету отправить менеджеру договора ПриатБанка. </TEXT> <TEXT align="center"> **АНКЕТА** \\ на подключение предприятий задолженности по стандартному протоколу </TEXT> \\ 1. Контактная информация ответственного за предоставление информации для подключения Предприятия к Платежной Системе: ^ ФИО ^ Мобильный телефон ^ E-mail ^ Skype name ^ | Фамилия Имя Отчество | +380… | example@gmail.com | Ваш логин в Skype | \\ 2. Адрес Шлюза, используемый для приема on-line запросов: <text background="warning"><nowiki>https://admin.ispnet.demo/ajax/index/privat2ndversion</nowiki></text> \\ 3. Клиентский SSL сертификат X.509: <text background="warning">нет</text> \\ 4. Пароль к SSL сертификату: <text background="warning">нет</text> \\ 5. Тестовый идентификатор: Логин тест абонента, по умолчанию <text background="warning">test</text> \\ 6. Методы стандартного протокола, реализуемые предприятием (необходимое- подчеркнуть): • __Предварительный поиск__ • __Поиск__ • Проверка на запись • Расчет комиссии • __Запись платежа__ • Отмена платежа • Выгрузка реестра \\ 7. Информация для подключения к платежной системе ПАО ПриватБанк: ^ N ^ Предприятие (наименование в соотв. с гос.регистрацией/общеупотребительное наименование) ^ ОКПО ^ Кодификатор предприятия ^ Услуга ^ Код услуги ^ Р/Счет ^ МФО ^ | 1 | ФОП ИВАНОВ ИВАН ИВАНОВИЧ | 2411111111 | 1 | Оплата за послуги Internet | 101 | UA703026890000026002055323333 | 301111 | | 2 | | | | | | | | | n | | | | | | | | </panel> billing/preferences/payment_system/abank.txt Последнее изменение: 3 лет назад — kagatan