Просмотр Исходного

{toc}

h2. О системе

ОСМП - Это платежная система, позволяющая пользователям самостоятельно пополнять свой счет. Документация протокола [ОСМП (pdf)|^qiwi_osmp_get.pdf]


h3. Требования

Для подключения этой системы необходимо:
Реальный внешний IP-адрес.

Для того чтобы пользователь мог внести платеж:
1. Пользователь не должен быть удален или отключен. То же самое для вышестоящих групп
2. При идентификации не должно быть неоднозначностей.

h3. Идентификация пользователей:

Идентификация пользователей при внесении платежа может осуществляться по логину, IP-адресу, номеру пользователя или номеру договора.

Настраивается в настройках платежных систем (_подробнее ниже_).

Полный список:
* ID учетной записи
* IP учетной записи
* логину учетной записи
* номеру договора
* номеру лицевого счета

*Рекомендуется использовать только один из способов одновременно для избежания неоднозначностей.*

h3. Подключение

# На странице ["Как стать партнером"|https://qiwi.ru/business/providers/howtobecome.action] - скачать и заполнить анкету
# Отправить заполненную анкету менеджеру, ответственному за ваш регион
# В ответ вы получите пакет документов, которые необходимо заполнить для согласования коммерческих условий использования сервиса
# После согласования коммерческих условий можно приступить к техническому тестированию
# Для тестирования технической части, отправьте письмо на адрес [rfp@osmp.ru|mailto:rfp@osmp.ru], указав в копии почтовый адрес курирующего менеджера. В письме укажите:
## Ваше Юридическое наименование
## Ваше Коммерческое наименование
## Адрес технического специалиста с вашей стороны
## Адрес технического специалиста с нашей стороны
## ФИО курирующего менеджера

Настройки подключения ОСМП производятся через главную страницу веб-интерфейса администратора Carbon Billing 5 / Платежные системы.
!osmp.png|border=0,width=900!

h2. Прием платежей по ОСМП от нескольких операторов. Изменение метки.

Если Вы заключили договор с 2 однотипными платежными операторами работающими по протоколу ОСМП, то будет удобнее, если сообщения о платежах будут приходить с разными метками.
Для этого необходимо:
# Сделать копию основного скрипта-обработчика ОСМП:
{code}
cp /app/asr_fiscal/usr/local/www/htdocs/osmp.php /app/asr_fiscal/var/www/custom_htdocs/osmp_NEW.php
{code}
# Внести изменения в копию скрипта:
{code}
/app/asr_fiscal/var/www/custom_htdocs/osmp_NEW.php
{code}
## Чтобы логи платежей писались в файл /app/asr_fiscal/var/log/NEW_OSMP.log, нужно изменить в строке
{code}
class OSMP extends
{code}
на
{code}
class NEW_OSMP extends
{code}
## Чтобы в журнале платежей и в финансовых операциях изменить описание платежной системы, нужно изменить строку:
{code}
$paywork = new OSMP($_REQUEST, 'OSMP_QIWI');
{code}
Вместо OSMP_QIWI задать новое значение метки оператора
{code}
$paywork = new NEW_OSMP($_REQUEST, 'NEW_OSMP');
{code}
*NEW_OSMP* нужно взять из строки:
{code}
class NEW_OSMP extends
{code}

После этого для первого платежного оператора ссылка будет иметь вид [https://169.254.14.43:1443/osmp.php], а для второго платежного оператора - [https://169.254.14.43:1443/custom_htdocs/osmp_NEW.php]

{note}Если вы используете отправку платежей без шифрования (по порту 1444) каталог для скрипта */app/asr_fiscal/var/www/custom_http/*, а ссылка будет иметь вид [http://169.254.14.44:1444/custom_http/osmp_NEW.php]{note}

h2. Изменение кода обработчика ОСМП
При настройке взаимодействия по протоколу ОСМП может потребоваться изменить текст сообщений в протоколе или другие параметры. Для этого нужно изменить класс обработчика:
# Скопируйте файл класса обработчика ОСМП:
{code}
cp /app/asr_fiscal/usr/local/www/htdocs/osmp_class.php /app/asr_fiscal/var/www/custom_htdocs/osmp_NEW.php
{code}
# Добавьте в конец файла с классом код вызова
{code:title=Файл с кодом вызова}
/app/asr_fiscal/usr/local/www/htdocs/osmp.php
{code}
{code:title=Код вызова}
$paywork = new OSMP_QIWI($_REQUEST, 'OSMP_QIWI');
$paywork->print_result();
{code}
# Внесите изменения в копию обработчика:
{code}
/app/asr_fiscal/var/www/custom_htdocs/osmp_NEW.php
{code}
## Чтобы логи платежей писались в файл /app/asr_fiscal/var/log/NEW_OSMP.log, нужно изменить в строке
{code}
class OSMP_Class extends PayWork
{code}
на
{code}
class NEW_OSMP extends PayWork
{code}
## Чтобы в журнале платежей и в финансовых операциях изменить описание платежной системы, нужно изменить строку:
{code}
$paywork = new OSMP($_REQUEST, 'OSMP_QIWI');
{code}
Вместо OSMP_QIWI задать новое значение метки оператора
{code}
$paywork = new NEW_OSMP($_REQUEST, 'NEW_OSMP');
{code}
*NEW_OSMP* нужно взять из строки:
{code}
class NEW_OSMP extends PayWork
{code}
# Внесите нужные изменения в код обработчика.

В результате новый обработчик будет доступен по ссылке [https://169.254.14.43:1443/custom_htdocs/osmp_NEW.php]