Спецификация работы псевдо-MT-подписки

Псевдо-подписка

Псевдо-подписка – это сервис, с помощью которого абонент подписывается на периодическое продление услуги посредством отправки MO-сообщений. Абонент при этом оплачивает исходящие, ответные SMS.

Создание сервиса

При создании сервиса партнеру нужно определиться со стоимостью и периодом подписки. Для разных цен периодов подписки используются номера разной стоимости. Также партнеру необходимо создать проект smsapi (с необходимыми префиксами) в системе smsbil и сказать об этом менеджеру. Менеджер должен добавить пометку (иначе, сообщения для абонентов рассылаться не будут).

Логика работы сервиса псевдо-подписка
Абонент вводит свой номер телефона в форме на сайте партнера системы smsbil. На указанный номер телефона абонента приходит бесплатное сообщение, содержащее информацию о подписке и то, что нужно отправить в ответной смс (эта ответная смс платная).
После получения ответной смс, абоненту приходит код, абонент вводит полученный код услуги в форму на сайте партнера и получает доступ к системе, по окончании периода подписки ему будут приходить SMS с предложением продлить услугу, он должен будет ответить на входящую смс, после чего ему придет уведомление о продлении подписки.

Принцип работы сервиса псевдо-подписка
Партнер размещает на своем сайте форму подписки. Для заявки на периодическую рассылку сообщений, абоненту требуется ввести в форме свой номер телефона.
Для регистрации абонента в псевдо-подписке, партнер передает на URL http://83.133.123.19/psmt.php GET запрос со следующими параметрами:

Параметры, предаваемые при регистрации абонента в подписке

Параметр Описание

act=reg_user

параметр, который обозначает запрос на регистрацию абонента

abonent

номер телефона абонента в формате: 7916XXXXXXX

sub_id

ID подписки

login

логин партнера

password

пароль партнера

msg

сообщение, которое необходимо отправить абоненту (в кодировке utf-8).

pref

префикс (глобальный префикс в системе smsbil)

subtxt

доп. префикс партнера и другие префиксы

short_num

короткий номер (от кого пришло смс сообщение и куда отправить ответ)

Пример url который должен получиться:
http://83.133.123.19/psmt.php?act=reg_user&login=ВАШ_ЛОГИН&password=ВАШ_ПАРОЛЬ&sub_id=ВАШ_НОМЕР_ПРОЕКТА_РАССЫЛКИ&msg=test%D1%82%D0%B5%D1%81%D1%82&pref=913&subtxt=1234&short_num=4345&abonent=79056543211


Ответ партнеру (если телефон не зарегистрирован в базе для сервиса sub_id):

ok
ххх
7хххххххххх
reg


Ответ партнеру (если телефон есть в базе для сервиса sub_id, – действует как продление подписки):

ok
ххх
7хххххххххх
cont


После регистрации отправки абонентом ответной смс ему приходит ответ от вашего обработчика в проекте smsapi.
Абонент вводит полученный код услуги в форму на сайте партнера.
Проверку кода партнер осуществляет самостоятельно.

Список возможных ошибок

Ошибка Описание

wrong login or password

неправильный логин или пароль партнера

abonent is undefined

неправильный номер телефона абонента

sub_id is undefined

неправильный ID подписки

subscription not found

подписка не найдена

operator not found

оператор не найден

error, msg empty

пустой параметр msg

error, short_num empty

пустой или не верный параметр short_num

error, pref empty

пустой параметр pref

error, period empty

не задан период рассылки

error, no subscr

такой подписчик не найден

sub_id is wrong

не верный параметр sub_id


Продление подписки

Продление псевдо-подписки осуществляется следующим образом.
Перед окончанием периода подписки, указанного партнером при регистрации сервиса, каждому абоненту отправляется бесплатное уведомление с текстом:

Для продления подписки на отправьте ответное смс с кодом 912psmt, Услуга платная, подробности на сайте sbhelp.ru Для отказа от подписки отправьте 912stop справки по тел: 88005555638 (звонок бесплатный)»

(префикс 912 может быть другой)

Информация об оплаченной смс также поступает на партнерский обработчик проекта smsapi, который используется для псевдоподписок.

Предоставление абоненту информации об условиях подписки и отказ от подписки

Информация об условиях псевдо-подписки должна содержаться на сайте партнера.

Информация об условиях подписки включает в себя:


* Для отказа от подписки абоненту необходимо отправить SMS с текстом 912stop<Код подписки> на номер 7517 (данное сообщение для абонента будет платное, но с минимальной ценой, с него партнер также получает отчисления – как при обычной смс).


Бесплатно абонент может отписаться на сайте партнера: Абонент вводит свой номер телефона в форму на сайте партнера.
Партнер передает на URL http://83.133.123.19/psmt.php GET запрос со следующими параметрами:

Параметры, предаваемые при отказе абонента от псевдо-подписки

Параметр Описание

act=unreg_user

параметр, который обозначает запрос на удаление абонента из рассылки

login

логин партнера

password

пароль партнера

sub_id

ID подписки

abonent

номер абонента

msg

сообщение которое будет отправлено абоненту

short_num

короткий номер с которого пришло смс-сообщение

pref

глобальный префикс smsbil

Пример url:
http://83.133.123.19/psmt.php?act=unreg_user&login=ВАШ_ЛОГИН&password=ВАШ_ПАРОЛЬ&sub_id=ВАШ_НОМЕР_ПРОЕКТА_РАССЫЛКИ&abonent=79056543211&msg=test%D1%82%D0%B5%D1%81%D1%82unreg&short_num=4345&pref=912

Если отписка прошла успешно, то партнер получает ответ:

ok
ххх
7хххххххххх
unreg

Пример оформления страниц проекта
На страницах сайта запрещается использовать формулировки типа «Бесплатный доступ», «Все даром» и т.д.
Информация на страницах сайта проекта не должна вводить пользователя в заблуждение.

Страница ввода номера телефона
Страница должна содержать:


Пример оформления страницы ввода номера телефона
 


Страница ввода кода
Страница должна содержать:


Пример оформления страницы ввода полученного кода
 


Страница ввода уже известного кода
Страница должна содержать:


Пример оформления страницы ввода уже известного кода
 


После ввода полученного кода, абонент получает доступ к заказанной услуге.

Пример оформления страницы отказа от псевдо-подписки
Страница должна содержать:


Пример оформления страницы отказа от подписки