V1 Программное обеспечение для организации пункта ввода-вывода и обмена электронных валют - korshu.ru o_O
Главная
Поиск по ключевым словам:
страница 1
Похожие работы
Название работы Кол-во страниц Размер
Свободное программное обеспечение (спо) это программное обеспечение... 5 663.96kb.
Учебно-методический комплекс по дисциплине «Программное обеспечение... 9 1350.59kb.
Программное обеспечение пэвм. Часть 2 4 779.44kb.
Действительные и страдательные причастия 1 112.01kb.
Программа (проект) информатизации №3 1 469.13kb.
Урок закрепления изученного материала Программное обеспечение: Microsoft... 1 56.73kb.
Российская федерация 1 502.31kb.
Начиная с 1 июля с г. пользователи услуг фиксированной связи смогут... 1 25.38kb.
Патология жирового обмена (учебно-методическое пособие для самостоятельной... 1 324.72kb.
Программы для электронных вычислительных машин, зарегистрированные... 9 2887.73kb.
Инструкция по использованию административной системы spip 3 1 164.58kb.
Необходимые компетенции и навыки для выполнения задания 1-го тура... 1 37.9kb.
Инструкция по работе с сервисом «sms-платеж» 1 218.94kb.

V1 Программное обеспечение для организации пункта ввода-вывода и обмена электронных - страница №1/1



v1

Программное обеспечение для организации пункта ввода-вывода и обмена электронных валют.

CopyRight © 2007-2014 BPanel.Ru

Оглавление


Оглавление 2

Информация 4

Системные требования 4

Обновление с предыдущих версий 5

Установка 5

Шаблоны 7

Панель Администратора 8

Общая информация 8

Добавление сотрудников 8

Партнерская программа 9

Направление обмена 9

Платежные аккаунты 10

Почтовые аккаунты 11

Отображение резерва валют на страницах сайта 11

CRON: выполнение заданий по расписанию 11

CRON: обновление курсов (cron_courses.php) 12

blockchain.info 12

btc-e.com 13

Стол помощи: техническая информация 14

Автоматическое открытие заявки 14

Звуковое оповещение 14

Автоматические ответы “текст на оплату” и др. 15

ICQ-боты 15

SMS-верификация и уведомления 15

EPochtaSMS 15

VoipCheap 16

Captcha (защита от ботов) 16

Верификация аккаунтов (файлы от клиентов) 16

WebMoney X19 Interface 16

WebMoney X2, X3 и X14 интерфейсы 17

WebMoney Login 17

Модули оплаты 19

WebMoney Merchant 19

LiqPay 19

Perfect Money 20

Liberty Reserve 21

OkPay 21

Qiwi NEW (международный, в т.ч. и Россия) 22

Qiwi OLD (только для России) 23

Paxum 23


W1 24

SolidTrust Pay 25

BitStamp 26

BTC-E 26


Privat24 27

EgoPay 27

LavaPay 28

Lesspay 29

InterKassa 29

API 30


Написание валют и названий платежных систем 31

Основная валюта 31

Пути к файлам 31

Кодировки различных языков 31

Расшифровка системных ошибок 33

Использованные модули 33

Работа скрипта на нескольких доменах 33

Проверка лицензии 34

Техническая Поддержка 34



Информация


ExchangeX – многофункциональное программное обеспечение для организации пункта ввода-вывода и обмена электронных валют, выполняющее ряд задач по приему, учету и обработке заявок.

Продукт изначально создавался для пункта обмена webmoney<-> paypal www.exchangex.ru, а с середины 2010 года стал доступен широкой аудитории. За годы работы и совершенствования реализованы самые необычные идеи, разработаны уникальные алгоритмы выполнения задач, максимально упрощены и автоматизированы действия администраторов.

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

Создание нового и общественно-полезного морально удовлетворяет разработчика, однако, для компенсации затрачиваемых сил и времени, скрипт вынужден быть платным.

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

Системные требования


PHP 5.3.x с Zend Guard Loader и модулями BCMath, Calendar и MbString.

MySQL 5.x.x; рекомендуемая кодировка базы: cp1251_general_ci.

E-Mail piping: необходимы php-библиотеки imap.

Защита от регистраций ботами: библиотека GD.

Поддержка сокетов для отправки сообщений в ICQ: функция socket_create.

Автоматическое обновление файлов скрипта: ZIP.

Работа с API сторонних систем: OpenSSL и cURL.

При установке скрипта (setup.php) программа выведет информацию о соответствии требованиям скрипта установленных на сервере модулей.

Рекомендуем увеличить до 57 секунд время выполнения скрипта (max_execution_time в php.ini) и таймаут MySQL (wait_timeout в my.cnf), а выделяемую память (memory_limit в php.ini) – до 128+ MB.

Причина: устранение ошибок при длительной работе IMAP.

Для повышения уровня безопасности установите в php.ini magic_quotes_gpc и safe_mode в значение On, а register_globals в Off.


Обновление с предыдущих версий


1. Распакуйте архив со скриптом у себя на компьютере.

2. Правильно измените данные в файле config.php.

3. Сделайте резервную копию базы данных.

4. Обновите файлы скрипта на сервере.

или

1-4*. Для загрузки автоматической загрузки файлов на сервер можно запустить /admin/autoupdate.php. Как правило, обновление конфигурационных файлов (config.php и т.п.) – не требуется.

Код скрипта и домен – такие же как и для загрузки с order.bpanel.ru, обновление лицензии – обновление файла license.php (как правило не требуется, см. историю изменений для версии, которую хотите установить).



* - при некоторых настройках PHP автоматическая загрузка и распаковка файлов невозможна.

Устранить ошибку “Permission denied” при автоматической загрузке файлов во многих случаях можно временной установкой атрибутов 777 на папку со скриптом и на /admin/.

5. Запустите admin/upgrade/index.php и поочередно перейдите по предложенным ссылкам.

6. После завершения обновления рекомендуется запустить скрипт /admin/database_check.php для проверки правильности обновления структуры базы данных.

За дополнительную плату возможно обновление скрипта непосредственно разработчиком BPanel. Подробная информация на http://bpanel.ru/order.php

Установка


1. Отредактируйте в блокноте файл

/config.php (пользователя и базу MySQL необходимо создать через панель управления сайтом)



2. Ручная загрузка файлов. Загрузите по FTP (можно в папку order) в режиме Binary файлы скрипта;

Необходимо, чтобы файл license.php (лицензия на домен, выдается на order.bpanel.ru) находился в корневой папке скрипта (вместе с файлами panel.php, reg.php, review.php и др.);

или

1-2*. Автоматическая загрузка файлов. Создайте на FTP папку admin, загрузите в нее файл autoupdate.php и запустите его в браузере. В форме укажите домен и код загрузки скрипта (выдается на order.bpanel.ru), данные доступа к базе MySQL (создать самому), папку со скриптом и пр. данные. Файлы последней версии ПО будут закачаны к Вам на сервер.

* - при некоторых настройках PHP автоматическая загрузка и распаковка файлов невозможна.

Устранить ошибку “Permission denied” при автоматической загрузке файлов во многих случаях можно временной установкой атрибутов 777 на папку со скриптом и на /admin/.

3. На папки admin/backup и admin/helpdesk установите атрибуты 755 или 777;

4. В панели управления сайтом обязательно запаролируйте доступ к папке /admin/;

5. Введите в браузере: http://сайт/папка_скрипта/setup.php и перейдите по ссылке "начать установку".

Прежде “боевого” запуска скрипта рекомендуется бегло просмотреть все страницы в админ-панели.

База уже содержит несколько аккаунтов, это сделано для скорейшего ознакомления со скриптом. По завершении ознакомления данные аккаунты можно удалить.

Шаблоны


Шаблоны для скрипта находятся в /admin/template/LANGUAGE/

menu.inc - меню для клиентов

panel_head.inc - Верхняя часть панели клиентов

panel_foot.inc - Нижняя часть панели клиентов

root_head.inc - Верхняя часть панели управления администраторов

root_foot.inc - Нижняя часть панели управления администраторов

Для того, чтобы вывести название или меню, вставьте в шаблон страницы следующий HTML-код:

---------------

Стили текста - во всех шапках шаблонов должен быть код

и






Панель Администратора



Общая информация


Пароли. При изменении данных рекомендуется, чтобы пароли аккаунтов клиентов, администраторов и пр. содержали только символы a-z, A-Z, 0-9 и “-”.

Вход


При установке галочки напротив пароля страница с запросом авторизации появляться более не будет (cookies).

Статусы заявок

CHECKING – присваивается автоматически после подачи заявки клиентом.

WAITING – ожидание от клиента оплаты, дополнительных данных или пр.

PAID – платеж от клиента получен, ожидание оплаты со стороны обменного пункта

COMPLETED – обмен завершен

CANCELLED – заявка отменена

Установка клиентом или администратором галочки “требуется ответ администратора” делает заявку видимой в открытых, где дополнительно отображаются CHECKING.

Открытые заявки (главная страница): отображаются заявки, в которые необходимо дать ответ:


  1. Со статусом CHECKING.

  2. С установленным чекбоксом “требуется ответ” администратора.

Архив заявок: заявки со статусами COMPLETED, WAITING, CANCELLED.

Всплывающее меню.

Для того чтобы меню всплывало при наведении на него мыши, измените в файле /admin/template/LANG/admin_data.js в строке, начинающейся с startMenu последний параметр с true на false.

Добавление сотрудников


Добавлять сотрудников и видеть их пароли может только пользователь с логином “admin”.

Партнерская программа


Пример php-кода для вставки в страницы Вашего сайта – в файле partnercode.php

После его добавления станет возможна работа страниц с партнерской программной, в calc.php и panel.php код уже есть.

Flash-баннеры должны быть созданы с передачей параметров через GET на Вашу страницу, пример:

Ссылка для регистрации в партнерской программы без подачи заявки: calc.php?mod=partner


Направление обмена


Валюта полей “Минимальная комиссия”, “Максимальная сумма к обмену”, “резерв” и др. – это валюта поля “Назначение”.

rates/exported_rates.php – название валюты для файла экспорта данных (его можно запускать с параметром format=1 2 или 3). PPUSD – доллары paypal, WMZ – WebMoneyZ, WMR – WebMoneyR и т.д. Заполнение поля не обязательно если использование exported_rates.php не планируется.

Короткое название – название для отображения в листингах, напр. “WMZ->PP”.

Не обязательно к заполнению если не планируете хранить в базе балансы средств на аккаунтах.

Наш счет по умолчанию To – счет/аккаунт по умолчанию, на который планируете получать средства.

Наш счет по умолчанию From - счет/аккаунт по умолчанию, с которого планируете отправлять средства.

Автооткрытие вместо … - не обязательно к заполнению, если нет срока верификации клиентов и нет зависимости сроков от сумм.

Показывать только на доменах – настройка, необходимая для использования скрипта на нескольких доменах. В ней можно через запятую перечислить домены, на которых должно отображаться данное направление (сравнение идет с переменной из файла license.php). Если отображение на всех доменах, то поле нужно оставить пустым.

Рекомендуется вынести exported_rates.php на отдельный субдомен, например rates.ВАШ_САЙТ, чтобы многочисленные запросы от мониторингов записывались в отдельный лог apache.

Платежные аккаунты


Неотображаемые комментарии – это служебные комментарии по счету, которые не отображаются в листинге платежных аккаунтов. Используются в большинстве случаев для указания в них паролей для API, переназначения secret keys и пр. в соответствии с информацией в этой документации.

FastInfo – персональное FastInfo для аккаунта, перекрывает глобальную настройку FastInfo по направлению.

Интеллектуальный подбор аккаунта для приема средств – полезен при наличии большого количества аккаунтов для приема или отправки средств по какому-либо направлению.

Параметры формы оплаты на стороннем сайте – настройка для генерации формы оплаты по какому-либо аккаунту для отправки клиента на оплату через сторонний сайт. Как правило, данная настройка вовсе не нужна обычному пункту обмена электронных валют, но все же:

В первой строке указывается URL формы, а в последующих – название переменной и ее значение. В значениях переменной можно использовать шаблоны FastInfo (TMPL_*).

Пример заполнения поля:



http://URL_НА_СТОРОННЕМ_ДОМЕНЕ/payments.php

orderid=TMPL_ORDERNUM

amount=TMPL_AMOUNT_SEND

currency=TMPL_CURRENCY_SEND

language=TMPL_LANG

variable1=value1

При таком заполнении поля вместо шаблона TMPL_PAYLINK в тексте ответа будет добавлена форма наподобие:


















Почтовые аккаунты


Создаются для проверки писем, получаемых на ящики, закрепленные за платежными системами (напр. PayPal). Полезно при необходимости проверки новых поступлений сразу на все счета. После получения письма из ящика оно не удаляется, при следующей проверке используется “пропуск писем”.

Отображение резерва валют на страницах сайта


При подключении в php-страницу сайта скрипта partnercode.php можно выводить и резерв конкретной валюты. Для этого на страницу нужно добавить переменную $text_balance[НОМЕР]

Пример образования переменной смотрите в partnercode.php


CRON: выполнение заданий по расписанию


Обычный (выполнение всех заданий)

/usr/bin/php /home/логин/public_html/папка/admin/cron.php

Ручной (выполнение указанных заданий)

/usr/bin/php /home/логин/public_html/папка/admin/cron.php go=manual ПАРАМЕТРЫ

Если заполнить поле "каждый XX день" или "через XX дней" числом "-1", то выполнение конкретного задания будет отключено.

Параметры:

order_email=1 уведомление о старых WAITING-заявках;

partner_delete=1 удаление старых переходов по партнерским ссылкам.

backup =1 резервное копирование на e-mail.

courses =1 получение курсов с cbr.ru на текущий день: “http://www.cbr.ru/scripts/XML_daily.asp?date_req=".date("d/m/Y") ;

checkmail =1 дополнительная проверка почтового ящика после ответа клиента на наш “текст на оплату”, задание полезно к выполнению, если письма от платежек приходят не сразу, а спустя какой-либо промежуток времени.

mail_actual=1 добавление ответов с вопросом об актуальности заявок.

mail_notactual=1 отмена заявок после истечения времени с момента добавления ответа выше.

qiwi_check=1 проверка поступления платежей в QiWiNEW по waiting-заявкам, работает только с go=manual.

Задания mail_actual и mail_notactual рекомендуется запускать с параметром go=manual (например, раз в час).

Задание checkmail рекомендуется запускать с параметром go=manual (например, раз в 5 минут или согласно установленной администратором соответствующей настройке в панели сотрудников).

changedate=no не изменять в базе дату последнего запуска cron (если параметр не указан и значение “go“ не “manual”, то дата изменяется)

для изменения даты при запуске go=manual обязательно указывайте changedate=yes

пример команды для крон для уведомления о старых WAITING-заявках и обновления курсов

/usr/bin/php /home/логин/public_html/папка/admin/cron.php go=manual order_email =1 courses =1

пример команды для крон для автоматических ответов “Уточнение актуальности” и “Потеря актуальности”

/usr/bin/php /home/логин/public_html/папка/admin/cron.php go=manual mail_actual=1 mail_notactual=1

запуск без параметра go=manual и невыполнение конкретных действий

пример


/usr/bin/php /home/логин/public_html/папка/admin/cron.php order_email =0

значит все действия кроме отправки уведомлений о старых WAITING-заявках

Ручной запуск крон полезен в тех случаях, когда сервер не справляется с обработкой всех или при необходимости тестировании выполнения конкретной функции.

CRON: обновление курсов (cron_courses.php)


Запускайте файл /admin/cron_courses.php с необходимой Вам периодичностью.

Настройки, с которыми запускается данный файл, находятся в разделе “Автоматическое обновление курсов” данных по направлениям обменов (при их редактировании).

Ниже приведены настройки для конкретных источников курсов.

blockchain.info


Курс направления обмена берется из URL:

http://blockchain.info/tobtc?¤cy=ВАЛЮТА&value=КОЛИЧЕСТВО

При настройке направления обмена в строке “Параметр обновления #1” укажите валюту, например “USD”, а в строке “Параметр обновления #2” укажите количество, например, “1”.

По умолчанию в базу в поле курса обмена вносится именно получаемое по ссылке выше число (например, для обмена какой-либо валюты на BitCoin). Для того чтобы в базу был внесен результат от действия 1/ПОЛУЧЕННОЕ_ЧИСЛО (например, для обмена BitCoin на какую-либо валюту), укажите что-либо в строке “Параметр обновления #3” (например, добавьте в это поле текст “обратно”).


btc-e.com


Курс направления обмена берется из параметра “last” по URL:

https://btc-e.com/api/2/btc_usd/ticker

https://btc-e.com/api/2/btc_eur/ticker

https://btc-e.com/api/2/btc_rur/ticker

https://btc-e.com/api/2/ltc_btc/ticker

https://btc-e.com/api/2/ltc_usd/ticker

https://btc-e.com/api/2/ltc_eur/ticker

https://btc-e.com/api/2/ltc_rur/ticker

или т.п.

Также можно указать URL https://www.bitstamp.net/api/ticker/

При настройке направления обмена в строке “Параметр обновления #1” укажите URL, по которому следует получать данные. В строке “Параметр обновления #2” можно указать количество, если оно отлично от “1”. На эту цифру будет умножено значение, полученное из поля “last” по URL выше.

По умолчанию в базу в поле курса обмена вносится именно получаемое по ссылке выше число (например, для обмена какой-либо валюты на BitCoin). Для того чтобы в базу был внесен результат от действия 1/ПОЛУЧЕННОЕ_ЧИСЛО (например, для обмена BitCoin на какую-либо валюту), укажите что-либо в строке “Параметр обновления #3” (например, добавьте в это поле текст “обратно”).


Стол помощи: техническая информация


Запуск e-mail piping: admin/imap.php, рекомендуется выполнять через CRON раз в 5-10 минут, для получения почты через протокол POP (по умолчанию – IMAP “143/notls”) при изменении настроек в поле “сервер” укажите “mail.server.com/pop”, порт: 110 (или 110/notls, если выдает ошибки о незащищенном соединении).

Если сервер поддерживает IMAP SSL, то в поле порт можно указать “993/ssl” или при ошибке проверки сертификата – “993/ssl/novalidate-cert ”.

Файлы-аттачменты в папке /admin/helpdesk/ :

a* - ответы в столе помощи

c* - файлы, загружаемые через формы в промежуточный период до добавления записи в базу

m* - мелодии для стола помощи

t* - билеты в столе помощи

u* - аватары клиентов

x* - файлы, загружаемые клиентами

z* - аватары сотрудников

"b","d","e","f","g","h","i","j","k","l","n","o","p","q","r","s","u","v","w","x","y","z"- неиспользуемые папки про запас

Автоматическое открытие заявки


Администраторы могут установить время автоматического открытия заявки с добавлением чекбокса “требуется ответ администратора”.

Задание выполняется при запуске imap.php. Если Вы не настраивали imap.php на e-mail piping, все равно для работоспособности функции автооткрытия нужно запускать imap.php.


Звуковое оповещение


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

Если звук не проигрывается, попробуйте установить QuickTime и/или проверьте настройки браузера.

Content-type для файлов:

.mp3 = audio/mpeg

.wav = audio/wav

.mid = audio/midi


Автоматические ответы “текст на оплату” и др.


По умолчанию предполагается, что администратор проверяет каждую заявку и одобряет ее проведение (добавляет в заявку ответ с текстом на оплату), запрашивает необходимую информацию или пр. Однако, в “настройки –> обработка заявок –> автоматические ответы” можно указать параметры, при которых ответ с текстом на оплату будет добавляться автоматически.

Помимо настроек выше необходимо, чтобы в направлении обмена был указан “Наш счет по умолчанию To”, а в платежных аккаунтах была запись об этом счете.


ICQ-боты


Используются для оповещения администраторов и клиентов о новых заявках, ответах и автооткрытиях заявок.

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

Регистрируем уин на icq.com, после чего добавляем его в скрипт. Оповещение одностороннее, т.е. если ответить боту, никакого действия не произойдет.

Уведомления в ICQ приходят только при online-статусе получателя.


SMS-верификация и уведомления



EPochtaSMS


URL сервиса: http://www.epochtasms.ru/

После регистрации и пополнения счета перейдите в на сайте сервиса в раздел “Панель управления ePochta SMS” -> ePochta SMS -> настройки и укажите там:

Включить XML интерфейс:

Режим XML интерфейса: рабочий

Далее перейдите в ExchangeX -> панель управления администраторов и укажите настройки подключения к сервису SMS-сообщений.

VoipCheap


URL сервиса: https://www. voipcheap.com/

Для работы с каким-либо из других URL сервиса, например

cheapvoip.com

cheapvoipsms.com

rynga.com

Укажите его в соответствующей настройке ExchangeX.


Captcha (защита от ботов)


При ошибках вида “Warning: file_put_contents(captcha.jpg)” установите на файл атрибуты, позволяющие производить его изменение (666 или другие в соответствии с настройками Вашего сервера).

Верификация аккаунтов (файлы от клиентов)


Предлагается несколько вариантов включения данного модуля:

  1. Добавить в меню (menu.inc) ссылку на раздел верификация: ?mod=verification

  2. Включить в настройки –> страницы –> панель клиента –> опция “Показывать на главной странице списка заявок ссылку на страницу верификации у неверифицированных:”.

В первом случае клиенты будут постоянно видеть ссылку на раздел верификации, а во втором – в зависимости от указанных данных в поле “Показывать на главной странице списка заявок ссылку на страницу верификации:” и настройки в п.2 выше.

WebMoney X19 Interface


Требования к обменным пунктам со стороны WebMoney: http://wiki.webmoney.ru/wiki/show/Interfeys_X19

Для включения функции http-проверки данных о пользователях необходимо выполнить условия по ссылке выше, после чего положить kwm-ключ webmoney в папку /admin/modules/WMXI/keys/ и отредактировать в файле /admin/modules/WMXI/examples/_header.php переменные

define('WMID', '000000000000');

define('PASS', 'PASSWORD'); // пароль от копии файла ключей

define('KWMFILE', "$_SERVER[DOCUMENT_ROOT]/$mysitedir"."admin/modules/WMXI/keys/000000000000.kwm");

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


WebMoney X2, X3 и X14 интерфейсы


X2 – автоматическая отправка платежа с кошелька, принадлежащего обменному пункту (выплата клиенту по заявке)

X3 – история операций по кошельку

X14 – безкомиссионнный возврат платежа отправителю (клиенту)

Помимо настроек по аналогии с X19 выше для работы X2 необходимо подключить его согласно http://wiki.webmoney.ru/projects/webmoney/wiki/%D0%98%D0%BD%D1%82%D0%B5%D1%80%D1%84%D0%B5%D0%B9%D1%81_X2

В настройках направления обмена укажите:

Платежная система назначения: WebMoney (автоматические оплаты)

А также в настройки –> стол помощи –> автоматические ответы

Укажите направления для “Автооплата и ответ "Обмен произведен" после получения платежа”.

При отключенной автоматической оплате, но указанным настройкам производить выплату вебмани сотрудник может одним кликом на ссылку “автооплата” при просмотре заявки.

WebMoney Login


При включенной соответствующей настройке пользователи могут авторизироваться в панели используя WMID, через сервис https://login.wmtransfer.com

Перейдите на сайт сервиса и заполните настройки Вашего ресурса:

Имя: придумайте любое

Время жизни тикета: 5

Допустимые методы аутентификации: все

Подтверждение операций: без подтверждения

Расширенные настройки: указать все

Далее добавьте URL сайта:

https://Ваш_сайт/panel.php?mod=main

Если https недоступен, то

http://Ваш_сайт/panel.php?mod=main

Скопируйте в блокнот появившийся в таблице ID сайта.

В настройках админ-панели ExchangeX укажите свой WMID, ID сайта выше и включите возможность авторизации пользователями через WebMoney.Login.

Модули оплаты


Если Вы хотите автоматически принимать оплату по заявкам, то укажите настройки в панели управления администратора для каждого модуля (Настройки => Основные) и установите дополнительные настройки, описанные ниже.

Общая рекомендуемая настройка для автоматических мерчантов: “Засчитывать оплату при несоответствии данных платежа“: No.

В настройках направления обмена в поле “Платежная система отправления клиентом (для автооплаты)” укажите нужную платежную систему. Валюта берется из первого поля (Отправление) настроек направления. Номер аккаунта/счета берется из “Наш счет по умолчанию To”.

WebMoney Merchant


URL: http://www.webmoney.ru

Для автоматического зачисления платежей необходимо иметь Аттестат Продавца.

Настройка Merchant: https://merchant.webmoney.ru/conf/purses.asp

После авторизации выберите кошелек и установите галочку напротив "Позволять использовать URL, передаваемые в форме".

Secret Key – заполнить в соответствии с одноименным полем в настройках мерчанта в админ-панели.

Высылать Secret Key на Result URL – нет.

Метод формирования контрольной подписи: SHA256

Выберите рабочий режим работы и активность "Вкл."

Прием чеков Paymer.com и пр. – по желанию.

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


LiqPay


URL: https://www.liqpay.com/

Подключите магазин на сайте liqpay.com:

Наличие order_id –ДА

Наличие подписи –ДА

URL магазина и уведомлений – оставить пустыми.

Отредактируйте секцию настроек мерчанта в админ-панели.

Для возможности использования нескольких кошельков при добавлении платежного аккаунта в поле “название” укажите номер Вашего счета, а в поле “Неотображаемые комментарии” укажите в первой строке “ID мерчанта”, во второй – “Подпись для остальных операций”, а в третьей (для работоспособности автоматической выплаты средств клиенту) – “Подпись для операции send money API LiqPay”, например:

i3190077790

g83melbk23EFW9gv0wmvj5rtk38FrEW

gh1melbk23EFW9gv0wmvj5rtk389ig6

Для работоспособности автоматической выплаты средств клиенту в настройках мерчанта на сайте LiqPay добавьте IP адрес Вашего сервера.

При настройке направления обмена в поле “Параметр для платежной системы” для того, чтобы клиент мог оплатить только конкретным способом оплаты, можно указать название способа согласно https://www.liqpay.com/?do=pages&p=cnb12 :

card – с карты

liqpay – с телефона

delayed – наличными


Perfect Money


URL: https://perfectmoney.com

В настройках аккаунта perfect money придумайте значение поля “Альтернативная кодовая фраза” (Alternate Merchant Passphrase Hash) и сохраните его.

В панели управления администратора в поле "Generate Alternate Merchant Passphrase Hash" вносим введенный выше пароль.

При последующих обновлениях настроек мерчанта поле "Generate Alternate Merchant Passphrase Hash" не заполнять.

Для возможности использования нескольких счетов при добавлении платежного аккаунта в поле “название” укажите номер Вашего кошелька (например U0000001), а в поле “Неотображаемые комментарии” укажите в первой строчке “Альтернативную кодовую фразу” (Alternate Merchant Passphrase Hash), во второй – “ID аккаунта” (цифровой логин, используемый при входе на сайт платежной системы), а в третьей – “Пароль доступа в аккаунт”, например:

GH87A134128A7CA762A1AD365E2C53B88



1234567

AccountPassword

ID аккаунта и пароль доступа к нему необходимо указывать, если Вы планируете использовать автоматическую выплату средств клиенту.


Liberty Reserve


URL: https://www.libertyreserve.com/

В аккаунте liberty reserve перейдите по ссылке “Merchant Tools” и далее “Create new store”. Придумайте и сохраните “Store Name” и “ Security Word”.

В панели управления администратора укажите название магазина и секретное слово.

OkPay


URL: https://okpay.com/

Добавьте e-mail аккаунта в настройки админ-панели, а номер кошелька – в настройки направления обмена.

Включение API на выплату средств на счет клиента производится в настройках кошелька на сайте okpay -> Integration -> API Access -> Enable API. Сгенерированный API пароль из поля “Access Password” нужно добавить согласно инструкции ниже.

Для возможности использования нескольких счетов, а также функции автоматической выплаты средств клиенту при добавлении платежного аккаунта в поле “название” укажите номер Вашего кошелька или e-mail, а в поле “Неотображаемые комментарии” укажите в первой строчке “e-mail”, во второй – “номер кошелька”, а в третьей – “API Access Password”, например:



email@email.com

OK000000001

a5Y3f28Tzx6WCe79Kpg3R4Esr

При настройке направления обмена в поле “Параметр для платежной системы” для того, чтобы клиент мог оплатить только конкретным способом оплаты, можно указать название способа (из поля “Code”) согласно https://www.okpay.com/en/developers/payment-methods.html

Это значение будет указано в переменной “ok_direct_payment”.

Qiwi NEW (международный, в т.ч. и Россия)


URL: http://w.qiwi.com/

Модуль включается за дополнительную плату в $100, т.к. был заказан одним из клиентов за деньги. Если Вам нужно подключение автоматического выставления счетов, свяжитесь с нами.

Настройка:

При добавлении направления обмена в поле “Наш счет по умолчанию To” укажите номер Вашего счета физического лица в qiwi с кодом страны (например “79091234567”, без знака “+”), а поле “Платежная система отправления клиентом” выставьте как “Qiwi NEW”.

При добавлении платежного аккаунта в поле “название” укажите номер Вашего счета физического лица в qiwi (например “+79091234567””, без знака “+”), а в поле “Неотображаемые комментарии” укажите пароль доступа к нему.

При переходе клиентом на страницу оплаты ему будет автоматически выставлен счет.

Проверка поступления оплаты производится обменным пунктом самостоятельно после получения уведомления от клиента.

Просмотреть список и статусы выставленных счетов в qiwi можно на стр. https://w.qiwi.com/order/list.action -> выставленные.

Для возможности повторного выставления счета по одной и той же заявке необходимо при просмотре заявки очистить поля “Дата выставления счета”.

Автоматическая проверка оплачен ли счет выполняется после нажатия клиентом на ссылку “ПРОВЕРИТЬ ОПЛАТУ” при просмотре заявки. Для работоспособности функции необходимо, чтобы в примечании к платежу был указан номер заявки.

Для работоспособности автоматической выплаты средств клиенту в настройках безопасности на сайте qiwi отключите “ Подтверждение платежей по SMS”.

Автоматический перевод qiwi выполняется примерно 80 секунд. Связано это с тем, что при работе с qiwi используется парсинг многих страниц, которые загружаются очень долго.

Qiwi OLD (только для России)


URL: http://w.qiwi.ru/

Модуль включается за дополнительную плату в $50, т.к. был заказан одним из клиентов за деньги. Если Вам нужно подключение автоматического выставления счетов, свяжитесь с нами.

Настройка:

При добавлении направления обмена в поле “Наш счет по умолчанию To” укажите номер Вашего счета физического лица в qiwi (например “9091234567”), а поле “Платежная система отправления клиентом” выставьте как “Qiwi”.

При добавлении платежного аккаунта в поле “название” укажите номер Вашего счета физического лица в qiwi (например “9091234567”), а в поле “Неотображаемые комментарии” укажите пароль доступа к нему.

При переходе клиентом на страницу оплаты ему будет автоматически выставлен счет.

Проверка поступления оплаты производится обменным пунктом самостоятельно после получения уведомления от клиента.

Просмотреть список и статусы выставленных счетов в qiwi можно на https://w.qiwi.ru/orders.action -> выставленные.

Для возможности повторного выставления счета по одной и той же заявке необходимо при просмотре заявки очистить поля “Дата выставления счета”.


Paxum


URL: https://www.paxum.com/

Модуль включается за дополнительную плату в $50, т.к. был заказан одним из клиентов за деньги. Если Вам нужно подключение автоматического выставления счетов, свяжитесь с нами.

Настройка:

Перейдите на страницу на https://paxum.com -> Merchant Services -> IPN Settings и нажмите на “Generate New Shared Secret”, после чего система вышлет Вам на e-mail “hash IPN” для автоматического получения уведомлений об оплате клиентом счета.

Перейдите на https://paxum.com -> Merchant Services -> API Settings и включите API, оставив все галочки, а в Allowed IPs укажите IP адрес Вашего сервера, на котором установлен скрипт ExchangeX.

Далее на этой же странице нажмите на “Generate New Shared Secret”, после чего система вышлет Вам на e-mail “hash API” для автоматического выставления счетов.

При добавлении направления обмена в поле “Наш счет по умолчанию To” укажите e-mail Вашего аккаунта в paxum, а полях “Платежная система отправления клиентом” и “Платежная система назначения” выставьте как “Paxum”.

При добавлении платежного аккаунта в поле “название” укажите e-mail Вашего аккаунта в paxum, а в поле “Неотображаемые комментарии” укажите в первой строке “hash IPN”, а во второй – “ hash API”, например:

9b04d152845ec0a378394003c96b3fc9

091d584fced301b442654dd8c23da594

При переходе клиентом на страницу ему будет предложено произвести платеж через мерчант. По завершении платежа скрипт автоматически внесет изменения в базу о том, что оплата зачислена.

Просмотреть список и статусы выставленных счетов в paxum можно на https://paxum.com -> Merchant Services -> IPN History и API History.

Если Вы планируете принимать оплату на e-mail, который не является основным на Вашем paxum-аккаунте, то посетите Панель сотрудников –> Настройки -> Мерчанты -> Liberty Reserve и Paxum и укажите в настройках paxum основной e-mail магазина.


W1


URL: http://www.w1.ru/

Модуль включается за дополнительную плату в $50, т.к. был заказан одним из клиентов за деньги. Если Вам нужно подключение автоматического выставления счетов, свяжитесь с нами.

Настройка:

Перейдите на страницу на http://www.w1.ru -> настройки -> интернет-магазин и установите:

Состояние: включен

Название: название Вашего сервиса

Адрес сайта: адрес Вашего сервиса

Адрес для оповещений: http://ВАШ_САЙТ/payments.php

Цифровая подпись (ЭЦП), тип: MD5

Скопируйте в блокнот секретный ключ подписи и нажмите на кнопку “сохранить” на сайте w1.

При добавлении направления обмена в поле “Наш счет по умолчанию To” укажите номер Вашего кошелька в w1, а поле “Платежная система отправления клиентом” выставьте как “W1”.

При добавлении платежного аккаунта в поле “название” укажите номер Вашего кошелька в w1, а в поле “Неотображаемые комментарии” укажите ключ MD5 подписи.

При переходе клиентом на страницу ему будет предложено произвести платеж через мерчант. По завершении платежа скрипт автоматически внесет изменения в базу о том, что оплата зачислена.

(На данный момент не реализовано) При настройке направления обмена в поле “Параметр для платежной системы” можно через запятую указать доступные направления для оплаты по данному направлению обмена в соответствии с http://www.w1.ru/checkout/site/develope/default.aspx?lang=ru-RU#step4

Эта настройка будет преобразована в данные для переменных WMI_PTENABLED (согласно документации выше).

При настройке направления обмена в поле “Параметр для платежной системы” для того, чтобы клиент мог оплатить только конкретным(и) способом(ами) оплаты, можно через запятую указать названия способов (из поля “Идентификатор”) согласно http://www.w1.ru/checkout/site/develope/default.aspx?lang=ru-RU#step4

Эти значения будут указаны в переменных “WMI_PTENABLED”.


SolidTrust Pay


URL: https://solidtrustpay.com/

Модуль включается за дополнительную плату в $50, т.к. был заказан одним из клиентов за деньги. Если Вам нужно подключение автоматического выставления счетов, свяжитесь с нами.

При добавлении направления обмена в поле “Наш счет по умолчанию To” укажите логин Вашего аккаунта в SolidTrust Pay, а поле “Платежная система отправления клиентом” выставьте как “ SolidTrust Pay ”.

При добавлении платежного аккаунта в поле “название” укажите логин Вашего аккаунта в SolidTrust Pay, а в поле “Неотображаемые комментарии” укажите second password доступа к аккаунту.

При переходе клиентом на страницу ему будет предложено произвести платеж через мерчант. По завершении платежа скрипт автоматически внесет изменения в базу о том, что оплата зачислена.


BitStamp


URL: https://bitstamp.net/

Модуль включается за дополнительную плату в $50, т.к. был заказан одним из клиентов за деньги. Если Вам нужно подключение автоматического выставления счетов, свяжитесь с нами.

При добавлении направления обмена в поле “Наш счет по умолчанию To” укажите номер Вашего аккаунта в BitStamp, а поле “Платежная система отправления клиентом” выставьте как “BitStamp”.

При добавлении платежного аккаунта в поле “название” укажите логин Вашего номер в BitStamp, а в поле “Неотображаемые комментарии” укажите пароль доступа о счету.

При переходе клиентом на страницу оплаты ему будет предложено ввести BitStamp Code.

Автооплата “Send to user” – отправляет средства на аккаунт клиента в bitstamp.net (валюта должна быть USD или BTC).

Автооплата “Bitcoin withdrawal” – отправляет средства на аккаунт клиента в bitcoin (валюта должна быть только BTC).


BTC-E


URL: https://btc-e.com/

Модуль включается за дополнительную плату в $50, т.к. был заказан одним из клиентов за деньги. Если Вам нужно подключение автоматического выставления счетов, свяжитесь с нами.

При добавлении направления обмена в поле “Наш счет по умолчанию To” укажите логин Вашего аккаунта в BTC-E, а поле “Платежная система отправления клиентом” выставьте как “BTC-E”.

При добавлении платежного аккаунта в поле “название” укажите логин Вашего аккаунта в BTC-E, а в поле “Неотображаемые комментарии” укажите в первой строке “UserID”, а во второй – “Secret key”, например:

11185

jgmK38f03nUFm34ldvb823nglwef0yh834rndfbmMKwefwBEpwqrqw125Rwegwer

При переходе клиентом на страницу оплаты ему будет предложено ввести BTC-E Code.


Privat24


URL: http://privatbank.ua/

Модуль включается за дополнительную плату в $50, т.к. был заказан одним из клиентов за деньги. Если Вам нужно подключение автоматического выставления счетов, свяжитесь с нами.

При добавлении направления обмена в поле “Наш счет по умолчанию To” укажите какое-либо слово, например “privat24usd”, а поле “Платежная система отправления клиентом” выставьте как “Privat24”.

При добавлении платежного аккаунта в поле “название” укажите заполненное ранее слово, например “privat24usd”, а в поле “Неотображаемые комментарии” укажите в первой строке “ID мерчанта”, а во второй – “Пароль мерчанта”, например:

73339

e3897b31a833ae2aa417ae94eaadac86

EgoPay


URL: https://egopay.com/

Модуль включается за дополнительную плату в $50, т.к. был заказан одним из клиентов за деньги. Если Вам нужно подключение автоматического выставления счетов, свяжитесь с нами.

На сайте платежной системы создайте записи в разделах “Stores” и “API”

Store:

Success Url: http://ПУТЬ_ДО_ФАЙЛА/payments.php?mod=ok



Fail Url: http://ПУТЬ_ДО_ФАЙЛА/payments.php?mod=error

CallBack Url: http://ПУТЬ_ДО_ФАЙЛА/payments.php

Test mode: чекбокс убрать

Verify integrity: чекбокс установить

API:

Enabled: чекбокс установить



Available Operations: Transfer чекбокс установить

Добавьте e-mail аккаунта в настройки направления обмена и в раздел “платежные аккаунты”.

При добавлении платежного аккаунта в поле “название” укажите e-mail аккаунта, а в поле “Неотображаемые комментарии” укажите в первой строчке “Store ID”, во второй – “Store Pass”, в третьей – “ API ID”, а четвертой – “API Pass”, например:

FFHSTOREIDHNK

u1APjeVSTOREPASSkKE3JHSGx4DUQR2x8Z

I9EAPIIDMS1R

efq54y0APIPASSPlRB9t5vlZ3SY1ER

Данные выше берутся на сайте платежной системы в разделах “Stores” и “API” после нажатия на картинку со знаком “i”.


LavaPay


URL: https://lavapay.com/

Модуль включается за дополнительную плату в $50, т.к. был заказан одним из клиентов за деньги. Если Вам нужно подключение автоматического выставления счетов, свяжитесь с нами.

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

Добавьте e-mail аккаунта в настройки направления обмена и в раздел “платежные аккаунты”.

При добавлении платежного аккаунта в поле “название” укажите e-mail аккаунта, а в поле “Неотображаемые комментарии” укажите в первой строчке “Wallet ID” (номер счета) , во второй – “wallet API password” (пароль API), например:

LP12345678

Xf96D345vcqwHy7b5R2KgBp3j8P9

При настройке направления обмена в поле “Параметр для платежной системы” для того, чтобы клиент мог оплатить только конкретным способом оплаты, можно указать название способа оплаты (параметр “LavaPayDirect ”) согласно странице https://www.lavapay.com/en/developers/sci/index.html#vars

Например: “LIQ” или др.

Lesspay


URL: https://lesspay.com/

Модуль включается за дополнительную плату в $50, т.к. был заказан одним из клиентов за деньги. Если Вам нужно подключение автоматического выставления счетов, свяжитесь с нами.

При добавлении платежного аккаунта в поле “название” укажите номер Вашего счета (например “ Z123456”), а в поле “Неотображаемые комментарии” укажите в первой строке “Store Name” Вашего магазина (согласно данным на сайте платежной системы), а во второй – “Secret key” этого магазина, например:



ExchangeXXX

2358asdn3ASasgf

InterKassa


URL: https://new.interkassa.com/

Подключите магазин на сайте interkassa.com:

Сохраните в блокнот Идентификатор магазина из раздела списка магазинов и секретный ключ из раздела “безопасность”.

В разделе “Интерфейс” включите настройку “разрешить переопределять в запросе”.

Тестовую платежную систему отключите.

Добавьте слово “InterKassa” или любое другое в настройки направления обмена и в раздел “платежные аккаунты”.

При добавлении платежного аккаунта в поле “название” слово “InterKassa” или любое другое, указанное выше, а в поле “Неотображаемые комментарии” укажите в первой строчке “Идентификатор магазина ”, а во второй – “секретный ключ”, например:

52a36ddebf4efc2e38db9102



p5pass672wordik912i

При настройке направления обмена в поле “Параметр для платежной системы” для того, чтобы клиент мог оплатить только конкретным способом оплаты, можно указать название способа оплаты (параметр “ik_pw_via”) согласно странице https://www.interkassa.com/lib/paysystems.currencies.export.php?format=xml

Например: “rbkmoney", “webmoneyz” или др.

API


Вы можете самостоятельно написать интеграцию с какой-либо платежной системой и при успешном приеме платежа направлять уведомление об этом в скрипт ExchangeX, который будет выполнят необходимые действия точно также, как если бы запрос был от платежной системы, уже интегрированной нами в скрипт.

Запрос производится на payments.php методом POST или GET.

Значения переменных:

api_code – секретный ключ в соответствии с настройками в панели сотрудников

api_number – номер заявки

api_amount – оплаченная сумма (сравнивается с данными в заявке)

api_currency – валюта платежа

api_comments – примечание/служебная информация по платежу


Написание валют и названий платежных систем


С целью максимальной интеграции с API сторонних платежных систем используйте при обозначении валют их международные названия на английском языке, например:

Доллар США: USD

Евро: EUR

Российский рубль: RUR

Украинская гривна: UAH

Также рекомендуется называть платежные системы на английском языке, например: WebMoney, PayPal, Bank Wire и т.д.


Основная валюта


По умолчанию в качестве основной валюты используется доллар США (USD).

Чтобы изменить валюту на напр. российский рубль (RUR) требуется



  1. Внести изменения в настройку “Название валюты”.

  2. В настройках валют панели администратора указать соответствующие курсы.


Пути к файлам


Подача заявок : /calc.php

Панель для Клиентов : /panel.php

Панель для Администраторов : /admin/index.php

CRON : /admin/cron.php

IMAP : /admin/imap.php

Кодировки различных языков


Кодировка текстов (веб и писем) указывается в панели администратора (по умолчанию windows-1251).

Кодировка, которая “перекрывает” значение по умолчанию задается в /admin/lang/LANGUAGE.php. Она распространяется на панель клиента и на многие письма (их шаблоны), отправка которых провоцируется клиентом.

Язык russian удалять нельзя, т.к. он используется для различных системных функций как в панели администратора, так и для страниц установки и обновления программы.

Расшифровка системных ошибок


#1 -- Ошибка проверки лицензии скрипта;

#2 -- -//-;

#3 -- -//-;

#4 -- -//-;

#5 -- -//-;

#6 -- -//-;

#7 -- Лицензия аннулирована или истек ее срок действия;

Использованные модули


В ходе разработки скрипта были использованы следующие модули сторонних производителей:

Отправка сообщений в ICQ: WebICQ Lite (http://wip.asminog.com/workshop/php2icq.html)

Проверка статуса ICQ-клиента перед отправкой сообщения: icq_status_class (http://www.phpclasses.org/package/1776-PHP-Retrieve-the-online-status-of-an-ICQ-user.html)

Предотвращение регистраций ботами: captcha (http://pear.php.net/package/Text_CAPTCHA)

Меню в админ-панели: Cascading Popup Menus (http://www.twinhelix.com/dhtml/popupmenu/)

Вставка смайликов в комментарии: javascript c http://archives.maillist.ru/13159/429435.html

WebMoney X19 & X8 интерфейсы: WMXI http://my-tools.net/wmxi/

jQuery: http://docs.jquery.com/Downloading_jQuery

Поддержка актуальности названий и буквенного обозначения стран: http://www.iso.org/iso/updates_on_iso_3166

Поддержка актуальности телефонных кодов стран: http://ru.wikipedia.org/wiki/Список_телефонных_кодов_стран

Определение страны пользователя по IP адресу: SxGeo http://sypex.net/ru/products/geo

Подсветка строк таблицы http://www.tigir.com/highlight_table_rows.htm

Обрезка аватаров http://recens.ru/php/resize_and_crop.html

Работа скрипта на нескольких доменах


Для этого необходимо иметь лицензию на каждый из планируемых к использованию доменов

Вариант 1. Установите копии скриптов с соответствующими license.php на разные аккаунты на сервере, но в config.php пропишите доступ к одной и той же базе.

Вариант 2. Добавьте после предпоследней строки license.php следующий код:

if (stristr(getenv("HTTP_HOST")," DOMEN”)) {

$license_domen="";

$license_type=" ";

$license_serial="";

}

Где “DOMEN” – дополнительный домен, а переменные $license-* - из license.php для этого домена.


Проверка лицензии


1. Внутренняя, программная (license.php);

2. Внешняя, запросом на order.bpanel.ru (order2.bpanel.ru).

Для проверки лицензии выделено два сервера: в США и в России. Не работает один – запрос идет на другой.

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

Продление срока действия лицензии: http://order.bpanel.ru

Техническая Поддержка


Возникли вопросы?

Смело задавайте их на нашем форуме: http://forum.bpanel.ru/index.php?showforum=23



P.S. В этом руководстве описана лишь небольшая часть функций программы.

Не бойтесь пробовать и экспериментировать :)