# ======================================================================== #
# Наименование модуля: fin_smscoin                                         #
# ======================================================================== #

Данный модуль является так называемым "Finance acceptor'ом" 
к модулю finance, он позволяет принимать средства на внутренний
счёт пользователя путём отправки SMS.
В качестве провайдера SMS трафика выступает сервис SMSCOIN.COM

>>>>                                                                    <<<<
>>>> Следует помнить, что реально на счёт вы получите в среднем         <<<<
>>>> 40-50% средств, потраченных пользователем.                         <<<<
>>>> Основную часть из оставшихся 50-60% заберёт себе оператор          <<<<
>>>> сотовой связи, кое-что себе оставит SMSCOIN                        <<<<
>>>>                                                                    <<<<

#=!======================================================================!=#
# ! ВНИМАНИЕ                                                             ! #
#=!======================================================================!=#
 Внутри финансовой системы (плагин finance) может существовать только одна 
валюта (на выбор пользователя: RUR, USD, EUR).
 При этом сервис SMSCOIN выплачивает заработанные средства только в USD вне
зависимости от валюты, которую заплатил пользователь при отправке платного SMS.
Для приведения валюты SMSCOIN в валюту сайта вам необходимо будет указать
коэффициент пересчёта.


Для работы модуля Вам необходимо:
1. Быть зарегистрированным в сервисе SMSCOIN.COM
2. Создать и активировать сервис `sms:банк`
3. Ваш сайт должен быть 24 часа в сутки 7 дней в неделю доступен  [ !!! ]
   из интернета, чтобы в любой момент система SMSCOIN  могла      [ !!! ]
   проинформировать Вас о поступлении новых средств.              [ !!! ]


Допустим, у вас уже есть всё из вышеперечисленного.
Тогда для использования этого модуля Вам необходимо:
1. Установить и активировать модуль finance
2. Для разделения реальных (когда деньги на ваш счёт поступают мгновенно) 
   и виртуальных платежей (как в случае с SMSCOIN - на ваш счёт средства
   поступают раз в месяц) платежей настоятельно рекомендуется в настройках
   плагина finance выделить отдельный баланс для приёма средств через SMS.
   К примеру, возьмём баланс №1. Заполним поля:
   * Монетарный? = Да
   * Тип         = SMS
   * Описание    = Поступления через SMS
3. Установить данный ( fin_smscoin ) модуль
4. Залогиниться на сайте http://smscoin.com/ и выбрать услугу `sms:банк`
5. Создать новый или отредактировать старый `sms:банк`, при этом необходимо
   заполнить следующие поля:
   * Страны - выбрать галочками страны, из которых вы планируете получать
              платежи. конечно, никто не мешает указать вообще все страны,
              но в этом случае вашим посетителям будет крайне неудобно 
              искать свою страну в списке возможных стран, что может 
              отрицательно отразиться на вашей прибыли
   * Секретный код - введите и запомните 8-15 случайных символов, они
                     вам понадобятся при конфигурировании плагина
   * Success URL - <значение этого параметра см. в конфигураторе плагина>
   * Fail    URL - <значение этого параметра см. в конфигураторе плагина>
   * Result  URL - <значение этого параметра см. в конфигураторе плагина>
   * Success URL метод - POST
   * Fail    URL метод - POST
   * Result  URL метод - POST
   * Задержка - 0
   * Активен - поставить галочку
   После заполнения полей - нажать кнопку "сохранить"
6. Зайти в настройки плагина fin_smscoin и заполнить поля:
   * Номер баланса на который начисляются бонусы
   * URL платёжного шлюза - зайдите в список сервисов `sms:банк`, выберите
     ссылку "Адрес шлюза" (в опциях) и пропишите указанное там значение в это
     поле (обычно там указано: http://bank.smscoin.com/bank/)
   * Идентификатор вашего сервиса `sms:банк` - числовой идентификатор сервиса,
     виден в списке ваших sms-банков (поле ID)
   * Секретный код - секретный код, который вы вводили при создании сервиса sms:банк
   * Вид суммы пополнения - в сервисе sms:банк существует 2 финансовые суммы:
      1. Сумма, которая списывается с баланса пользователя
      2. Сумма, которую вы получите
      В данном случае вам необходимо определить, на какую именно сумму вы хотите
      пополнять баланс пользователя.
   * Коэффициент пересчёта из `USD` в валюту сайта - здесь вам необходимо указать курс
     по которому на внутренний баланс пользователя будут зачисляться средства.

7. Активировать плагин fin_smscoin

После выполнения этих шагов ваши пользователи смогут пополнять свой баланс при
помощи отправки платных SMS сообщений.
