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

*О системе*
ОСМП - Это платежная система, позволяющая пользователям самостоятельно пополнять свой счет. Документация протокола [ОСМП|https://w.qiwi.com/business/agents/files/protocol_pacetn_obmena.pdf]



*Требования*
Для подключения этой системы необходимо:
1. Carbon Billing (2.5.11 или выше)
2. Реальный внешний IP-адрес

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

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

*Подключение*
1. На странице ["Как стать партнером"|https://qiwi.ru/business/providers/howtobecome.action] \- скачать и заполнить анкету

2. Отправить заполненную анкету менеджеру, ответственному за ваш регион

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

4. После согласования коммерческих условий можно приступить к техническому тестированию

5. Для тестирования технической части, отправьте письмо на адрес [rfp@osmp.ru|mailto:rfp@osmp.ru], указав в копии почтовый адрес курирующего менеджера. В письме укажите:
5.1. Ваше Юридическое наименование
5.2. Ваше Коммерческое наименование
5.3. Адрес технического специалиста с вашей стороны
5.4. Адрес технического специалиста с нашей стороны - [support@carbonsoft.ru|mailto:support@carbonsoft.ru]
5.5. ФИО курирующего менеджера

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

6. В соответствие с присланной от ОСМП инструкцией, зайдите в интерфейс автоматического тестирования на сайте ОСМП

7. Перед тем как указать технические данные, выполните в локальной меню Carbon Billing *Конфигурирование сервера \-> Настройка платежных систем*, следующие действия:
7.1. Поставьте галочки *Включить SSL WEB-сервер для платежей* и *Требовать и проверять клиентский сертификат*

h6. Примечание

{color:#ff0000}Для версий от 3.8 также нужно указать поле для идентификации пользователей в  ОСПМ подобных системах{color}

7.2. Поставьте галочку *Настройка платежной системы ОСМП \-> Включить платежную систему ОСМП*
7.3. Выберите пункт меню *Настройка платежной системы ОСМП \-> Генерация сертификатов для ОСМП*
7.4. В диалоге указать адрес Вашей электронной почты на которую сервер должен прислать SSL-сертификаты, необходимые для работы с ОСМП. Эти сертификаты потребуются во время проведения тестирования. Если на Carbon Billing не настроен почтовый сервер сертификат необходимо забрать по протоколу scp программой Winscp. Созданный сертификат будет сохранен в директорию /var/lib/usrcert.
7.5. Произведите мягкую перезагрузку

8. В интерфейсе автоматического тестирования на сайте ОСМП, В разделе *Справочники \-> Провайдеры \-> Технические данные* укажите:
8.1. _URL платежного приложения:_ https://Ваш внешний IP или доменное имя:1443/osmp.php
8.2. _Список адресов электронной почты для отправки реестров:_ Укажите почтовый адрес для отчетов
8.3. _Регулярное выражение для проверки правильности идентификатора:_ 

{code}
^[a-zA-Z0-9.]$ или ^[0-9a-zA-Z.-]$
{code}
(в зависимости от формата номера договора)
8.4. _Серверный сертификат провайдера в формате Х509:_ Файл приложен в письме. Имя - osmp*_CA.crt
8.5. _Клиентский сертификат для ОСМП в формате PKCS12:_ Файл приложен в письме. Имя - osmp*.pfx
8.6. _Пароль для клиентского сертификата:_ Указан в письме
8.7. _Использовать бэйсик-авторизацию:_ Снимите галочку
8.8. _Логин и пароль, если требуется авторизация (Basic):_ Не указывайте

9. Проведите тестирование

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

11. Возможно, потребуется генерация новых ключей. Для этого повторите пункт 7.3.

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

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

1) Загрузить сервер в режим [уд. помощника|Пользователь root. Режим удаленного помощника. Постоянный удаленный помощник] и подключиться под пользователем root.

2) Выполнить команды:
{code}

3) Внести изменения в скрипт:
{code}mcedit /var/www/fiscal/htdocs/osmp_2.php

изменить строку:
$PAY_OPERATOR='OSMP';

присвоить переменной новое значение метки оператора

$PAY_OPERATOR='OSMP_NEW';{code}


После этого для первого платежного оператора ссылка будет иметь вид http://<ip>/osmp.php, а для второго платежного оператора - http://<ip>/osmp_2.php

Примечание: проверьте что у редактируемого файла&nbsp;osmp_2.php выставлены правильные права и владелец.

должно быть так:
{code}
-r-xr-x--x &nbsp; &nbsp;1 mhttpd_F mhttpd_F &nbsp; &nbsp; 8471 Фев 20 13:10 /var/www/fiscal/htdocs/osmp_2.php
-r-xr-x--x &nbsp; &nbsp;1 mhttpd_F mhttpd_F &nbsp; &nbsp; 8464 Дек 31 &nbsp;2005 /var/www/fiscal/htdocs/osmp.php
{code}
если это не так, то права и владельца нужно поставить командой
{code}
cd /var/www/fiscal/htdocs
chown --reference osmp.php osmp_2.php
{code}