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

{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]