ПриватБанк - Выписка (Р/С)

Вернуться на уровень выше

С версии 2.7.8 появилась возможность пополнять абонентов из выписки по расчётному счёту. К сожалению, это звучит только просто, т.к. настройки потребуют некоторых специальных знаний.

Для того, чтоб активировать эту услугу нужно со стороны ПриватБанка: вернуть авторизацию по логину и паролю, а также убрать подтверждение через СМС на телефон.
Настоятельно рекомендуем использовать отдельный Р/С для использования данного функционала. Т.е. не использовать для ПриватБанк Выписка и ПриватБанк V.2 один и тот же Р/С.

С версии 2.8.14 появилась возможность переопределить сумму платежа из описания платежа.

C версии 3.01.02 добавилась возможность выгружать выписки через автоклиент. Более подробно настройка автоклиента описана здесь

При получении ответа от сервера ПриватБанка мы просматриваем все подходящие платежи по критериям (подробное описание критериев):

  • состояние документа (info/@state): "r" - проведен
  • вид платежа (info/@flinfo): "r" - реальный
  • тип документа (info/@doctype): "m" - мемориальный ордер (или "p" - 'расходный ордер' и сумма больше нуля (<amount amt="больше нуля">))
  • в поле "назначение платежа" удалось/не удалось обнаружить идентификатор пользователя с помощью указанного регулярного выражения

По идентификатору пользователя производится поиск абонента. Если он обнаружен, то его баланс увеличивается на указанную сумму. В противном случае, этот платёж заносится в базу и его можно найти в детальном отчёте "ПриватБанк - выписка" со статусом "Пользователь не найден":

nolink&|

Услуга, для пополнения счета, может быть 3-х видов:

  • пополнение по номеру UID абонента
  • по логину абонента
  • по № договора абонента

В данной платёжной системе реализована система алгоритмического поиска абонентов, с которой рекомендуем ознакомиться по ссылке ниже:
Алгоритм поиска абонентов при пополнении

Поиск и оплата происходит для основных групп пользователей: обычный (базовый) и замороженный.

В зависимости от того в каком виде будет получен запрос, сервер MikBill автоматически его обработает, настроек не требует.

Системные опции:

nolink&|


Необходимо указать:

  • Номер расчётного счёта;
  • Пароль пользователя;
  • Имя пользователя;
  • REG EXP - регулярное выражение для поиска в поле "назначение платежа" идентификаторов пользователя (о регулярных выражениях, Regexp quick reference) - нужно указать только "сердцевину", как на скриншоте;
  • Указать позицию идентификатора в результатах поиска (по умолчанию - 1);
  • Количество дней - указать кол-во дней, за которые должны проверяться выписки раз в сутки.
  • Аббревиатура валюты = UAH - если Вы используете гривны в биллинге как основную валюту.

По желанию/необходимости можно указать "Искл. наимен. плат" - исключаем платежи по наименованию плательщика. Если это поле пустое, то фильтр не применяется. В поле может быть указано не более одного 'наименования плательщика', которого надо исключить. Используется для недопускания дублирования платежей из 'ПриватБанк V.2', если на один Р/С подключены 2 системы.

После настройки в "системных опциях" всех необходимых параметров нужно настроить автоматический вызов двух консольных команд (Как это сделать?):

  • getPrivatTodayPayments
  • getPrivatPreviousPayments
Рекомендация использовать выгрузку за 3 суток.

Рекомендуемое время вызова "getPrivatPreviousPayments" - в начале следующих суток, а "getPrivatTodayPayments" - в зависимости от того, какого Вы хотите отклика от системы - задержку во времени между зачислением на Р/С и пополнением абонента в системе.

Если Вы фильтруете исходящий от сервера биллинга трафик, то разрешите доступ на: https://client-bank.privatbank.ua

Как обычно, все операции можно увидеть в "Отчёты → терминалы → детальные → ПриватБанк Выписка":

nolink&|

Поле "всего" отражает количество средств, которое было зачислено абонентам.

Во все остальные финансовые отчёты это так же было добавлено.

Настройки для субпровайдера

  • billing/preferences/payment_system/privat_vipiska.txt
  • Последние изменения: 6 дней назад
  • — Максим Ступаков