Инструкция по подключению ОСМП. Несколько операторов

О системе

Требования
Идентификация пользователей
Подключение

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

О системе

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

Требования

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

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

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

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

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

Полный список:

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

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

Подключение

На странице "Как стать партнером" - скачать и заполнить анкету
Отправить заполненную анкету менеджеру, ответственному за ваш регион
В ответ вы получите пакет документов, которые необходимо заполнить для согласования коммерческих условий использования сервиса
После согласования коммерческих условий можно приступить к техническому тестированию
Для тестирования технической части, отправьте письмо на адрес rfp@osmp.ru, указав в копии почтовый адрес курирующего менеджера. В письме укажите:
1. Ваше Юридическое наименование
2. Ваше Коммерческое наименование
3. Адрес технического специалиста с вашей стороны
4. Адрес технического специалиста с нашей стороны
5. ФИО курирующего менеджера

Настройки подключения ОСМП производятся через главную страницу веб-интерфейса администратора Carbon Billing 5 / Платежные системы.

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

Если Вы заключили договор с 2 однотипными платежными операторами работающими по протоколу ОСМП, то будет удобнее, если сообщения о платежах будут приходить с разными метками.
Для этого необходимо:

Сделать копию основного скрипта-обработчика ОСМП:

cp /app/asr_fiscal/usr/local/www/htdocs/osmp.php /app/asr_fiscal/var/www/custom_htdocs/osmp_NEW.php

Внести изменения в копию скрипта:
```
/app/asr_fiscal/var/www/custom_htdocs/osmp_NEW.php
```
1. Чтобы логи платежей писались в файл /app/asr_fiscal/var/log/NEW_OSMP.log, нужно изменить в строке
```
class OSMP extends
```
  на
```
class NEW_OSMP extends
```
2. Чтобы в журнале платежей и в финансовых операциях изменить описание платежной системы, нужно изменить строку:
```
$paywork = new OSMP($_REQUEST, 'OSMP_QIWI');
```
  Вместо OSMP_QIWI задать новое значение метки оператора
```
$paywork = new NEW_OSMP($_REQUEST, 'NEW_OSMP');
```
  NEW_OSMP нужно взять из строки:
```
class NEW_OSMP extends
```

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

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

Изменение кода обработчика ОСМП

При настройке взаимодействия по протоколу ОСМП может потребоваться изменить текст сообщений в протоколе или другие параметры. Для этого нужно изменить класс обработчика:

Скопируйте файл класса обработчика ОСМП:

cp /app/asr_fiscal/usr/local/www/htdocs/osmp_class.php /app/asr_fiscal/var/www/custom_htdocs/osmp_NEW.php

Добавьте в конец файла с классом код вызова
Файл с кодом вызова
```
/app/asr_fiscal/usr/local/www/htdocs/osmp.php
```
Код вызова
```
$paywork = new OSMP_QIWI($_REQUEST, 'OSMP_QIWI');
$paywork->print_result();
```
Внесите изменения в копию обработчика:
```
/app/asr_fiscal/var/www/custom_htdocs/osmp_NEW.php
```
1. Чтобы логи платежей писались в файл /app/asr_fiscal/var/log/NEW_OSMP.log, нужно изменить в строке
```
class OSMP_Class extends PayWork
```
  на
```
class NEW_OSMP extends PayWork
```
2. Чтобы в журнале платежей и в финансовых операциях изменить описание платежной системы, нужно изменить строку:
```
$paywork = new OSMP($_REQUEST, 'OSMP_QIWI');
```
  Вместо OSMP_QIWI задать новое значение метки оператора
```
$paywork = new NEW_OSMP($_REQUEST, 'NEW_OSMP');
```
  NEW_OSMP нужно взять из строки:
```
class NEW_OSMP extends PayWork
```
Внесите нужные изменения в код обработчика.

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