Документация по версии 1.5

Материал из ExpertBilling
Версия от 20:38, 16 марта 2013; Admin (обсуждение | вклад) (Платёжные системы)

Перейти к: навигация, поиск

Введение

Этот раздел wiki будет посвящён новой версии биллинг-системы ExpertBilling 1.5.


ExpertBilling 1.5 принципиально другая биллинга система и не многим похожа на предыдущие версии. Она содержит веб-интерфейс, рассчитанный на работу с абонентскими базами до 300 000 - 500 000 абонентов и вертикально/горизонтально масштабируемую структуру, которая способна плавно наращивать вычислительные мощности.

Код ExpertBilling теперь открыт на 70%. Вы свободно можете модифицировать интерфейс и логику отсылки команд на сервера доступа.

ExpertBilling использует зарекомендовавшие себя production решения RabbitMQ, Celery, PostgreSQL, которые используются такими гигантами как Twitter, VmWare и многими другими.

ExpertBilling стал гораздо аккуратнее и логичнее в своей работе.

ExpertBilling теперь не привязывается к жёсткому диску. Вы сможете переустановить систему в любой момент, используя свою лицензию.

Увеличение количества абонентов стало возможно без обновления системы.

Кроме этого ExpertBilling 1.5 стал гораздо безопаснее и надёжнее. Мы проделали огромную работу и надеемся, что это не напрасно.

Обратите внимание, что выложенная версия ExpertBilling 1.5 является alpha версией и вы её используете на свой страх и риск. Мы просим вас сообщать на форуме о всех найденных проблемах, чтобы они были быстрее исправлены.

Установка

Перед началом работы выполните следующее:

Выполните в консоли с правами суперпользователя:

$sudo -s
#apt-get install fabric


Возможно 3 варианта установки ExpertBilling 1.5. Обновление, апгрейд, апгрейд с версии 1.4.1. Апгрейд с более ранних версий не предусмотрен.


Установка с нуля

Скачанный архив нужно положить в /opt/ и распаковать из него только скрипт-инсталлятор fabfile.py и инструкцию по установке.

#cd /opt/
#tar -xvzf путь к архиву с биллингом fabfile.py install.txt

Установка postgresql 9.1

#apt-get update
#apt-get install fabric postgresql-9.1 postgresql-contrib-9.1 postgresql-server-dev-9.1

Создание директории:

#mkdir /opt/ebs


Создание пользователя базы данных и базы данных. Рекомендуемый пароль - ebspassword:

#su postgres
$createuser -P -s ebs
$createdb -O ebs ebs
$exit
$exit

Запустите установку биллинга с нуля с правами root-а из директории /opt/.

#fab deploy:demo.tar.gz 

После того, как устанвока завершится - откройте в браузере айпи вашего сервера и войдите в веб-кабинет

Апгрейд

Скачанный архив нужно положить в /opt/ и распаковать из него только скрипт-инсталлятор fabfile.py и инструкцию по установке.

#cd /opt/
#tar -xvzf путь к архиву с биллингом fabfile.py install.txt

При апгрейде с версии 1.4.1 нужно выполнить

#fab upgrade:demo.tar.gz

Апгрейд с версии 1.4.1

Скачанный архив нужно положить в /opt/ и распаковать из него только скрипт-инсталлятор fabfile.py и инструкцию по установке.

#cd /opt/
#tar -xvzf путь к архиву с биллингом fabfile.py install.txt

При апгрейде с версии 1.4.1 нужно выполнить

#fab upgrade_14:demo.tar.gz

После установки откройте файл /opt/ebs/web/ebscab/settings_local.py и переопределите в нём значения из файла /opt/ebs/web/ebscab/settings.py. Этот файл не будет перезатираться при обновлениях.

После настройки веб-кабинета:

  1. /etc/init.d/apache2 reload

Внимание!!! Это не финальная версия 1.5. О всех найденных прблемах просьба писать на форуме http://forum.expertbilling.ru/

Имя и пароль по-умолчанию для входа в веб-кабинет admin/admin.


Платёжные системы

В ExpertBilling 1.5 реализован приём следующих типов платежей:

  • QIWI
  • Единая Касса w1.ru
  • Сбербанк РФ
  • Liqpay
  • EasyPay

Настройка производится разово в файле settings_local.py веб-кабинета:

GETPAID_BACKENDS = ('payments.easypay',
                    'payments.liqpay',
                    'payments.ru_sberbank',
                    'payments.w1ru',
                    'payments.qiwiru',
                    )
                  
GETPAID_BACKENDS_SETTINGS = {
    # Please provide your settings for backends
    'payments.liqpay' : {
        'TYPE': 'frontend', 
        'DEFAULT_CURRENCY' : 'UAH',
        'MERCHANT_ID': 'i7444123444',
        'MERCHANT_SIGNATURE': 'LMoTlGet9IVubuNbBvKIZ0wNDdsluOLsIvdzd',
        'PAY_WAY': ('card', 'liqpay', 'delayed'),
        'EXPIRE_TIME': 36,

    },

    'payments.easypay' : {
        'TYPE': 'backend', 
        'DEFAULT_CURRENCY' : 'UAH',
        'SERVICE_ID' : '1',
        'allowed_ip': ('93.183.196.28', '93.183.196.26'),

    },
    'payments.ru_sberbank' : {
                          'TYPE': 'backend', 
        'DEFAULT_CURRENCY' : 'RUB',
        'PASSWORD' : '12345',
        'allowed_ip': ('93.183.196.28', '93.183.196.26'),

    },
    'payments.w1ru' : {
        'TYPE': 'frontend', 
        'DEFAULT_CURRENCY' : 'RUB',
        'MERCHANT_ID': '163789612661',
        'MERCHANT_PASSWORD': 'MFVSdmZNajdBRXdcWmE3Z191cjBLWFJsZjhb',
        #=======================================================================
        # 'PTENABLED':[
        #             'YandexMoneyRUB',
        #           'WebMoneyRUB', 
        #             ],
        #=======================================================================
        'PTDISABLED':[
                     ],
        'allowed_ip': ('93.183.196.28', '93.183.196.26'),
        'EXPIRE_DAYS': 31,

    },
    'payments.qiwiru' : {
        'TYPE': 'frontend', 
        'DEFAULT_CURRENCY' : 'RUB',
        'TERMINAL_ID' : '12345',
        'TERMINAL_PASSWORD' : '12345',
        'LIFETIME': 48,
        'ALARM_SMS': 0,
        'ACCEPT_CALL': 0,


    },
}

За то, какие способы оплаты будут доступны пользователям, отвечает переменная GETPAID_BACKENDS. Настройки конкретного платёжного шлюза находятся в соответствующих секциях GETPAID_BACKENDS_SETTINGS.

Все типы платежей разбиты на 2 логических типа - frontend и backend. Frontend доступен для выбора через веб-кабинет. Backend используется, если оплата происходит без взаимодействия пользователя с веб-кабинетом. К примеру через терминал. Не меняйте эти значения.

Просмотр оплаченных счетов доступен через интерфейс администратора по ссылке /ebsadmin/payment/. Допускается изменять статус платежа. Пополнение счёта абонента или удаление пополнения произойдёт автоматически.