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

О системе

ОСМП - Это платежная система, позволяющая пользователям самостоятельно пополнять свой счет. Документация протокола ОСМП (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