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

О системе

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

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

О системе

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

Требования

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

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

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

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

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

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

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

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

Подключение

Настройки подключения ОСМП производятся через главную страницу веб-интерфейса администратора 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