• API Wap-click
  • API разовый клик
  • Правила оформления сайтов
  • Скачать
API Wap-click

Дата последнего обновления 16 декабря 2015 г.

ОПРЕДЕЛЕНИЯ

ПОДПИСКА – услуга, подразумевающая регулярные списания фиксированных сумм денежных средств и предоставляющая доступ к определенному контенту на весь период действия услуги.

ПОТОК – гибко настраиваемый субаккаунт партнера, предназначенный для выделения трафика определенной категории (тематика трафика, источник и т.д).

ТАРИФИКАТОР – комплекс оборудования и ПО Mosbill, осуществляющий взаимодействие с оператором в течении всего жизненного цикла подписки.

СЕРВИС – Согласованная с оператором витрина, предоставляющая абоненту оригинальный контент на платной основе.

LANDING – принадлежащая оператору страница подтверждения согласия с подключением услуги и списанием денежных средств, кастомизированная в соответствии с тематикой сервиса.

РОТАЦИЯ – механизм, позволяющий предложить абоненту альтернативный Landing, в случае отказа от подписки, либо ошибки на стороне Оператора.

TRAFFBACK_URL – url, задаваемый для переадресации абонента в случае невозможности подписки абонента на основной и альтернативный Landing.

BACKURL – url, задаваемый для каждого сервиса, для переадресации абонента в случае успешного подключения подписки.

NOTIFICATION_URL - url обработчика уведомлений на стороне партнера.

СЦЕНАРИЙ АКТИВАЦИИ ПОДПИСКИ

1.Для инициализации подписки Партнер вызывает метод begin_subscribe. В ответ тарификатор отдает уникальный идентификатор операции tid.

2.Получив идентификатор, партнер переадресует абонента на тарификатор, добавляя GET параметр, содержащий полученный ранее tid.

3.Тарификатор осуществляет переадресацию абонента на лэндинговую страницу Оператора, где абонент либо подтверждает свое согласие с услугой, либо отказ от нее.

4.После подтверждения абонентом согласия с услугой происходит переадресация абонента на BACKURL (по требованиям Оператора, абонент должен быть переадресован на страницу с контентом той тематики, на которую он подписался), а на обработчик партнера поступает уведомление о подключении услуги и списании денежных средств.

Важно понимать, что уведомление и переадресация абонента не связанные события. Уведомление может поступить как раньше чем произойдет переадресация абонента так и позже этого.

5.В случае отказа абонента, или невозможности подписки на стороне Оператора или тарификатора по ряду причин, тарификатор производит переадресацию абонента на URL, заданный Партнером для traffback_url.

6.При наличии в настройках Потока альтернативных лэндингов, тарификатор при отказе абонента или невозможности подписки на основной лэндинг, производит переадресацию абонента на альтернативные landing page, настроенные для потока. Если ни на одном из доступных landing page подписка не оформляется, тарификатор переадресует абонента на traffback_url.

ОПИСАНИЕ МЕТОДОВ

1) Метод begin_subscribe. Получение идентификатора транзакции.

Выполняется HTTP GET запросом на URL http://suscribe.mosbill.ru/begin_subscribe

Передаваемые параметры:

ПараметрОписаниеФорматОбязательный
stream_idИдентификатор потокаСтрока, до 40 символовДа
ipIP-адрес абонентаФормат AAA.BBB.CCC.DDDДа, если отсутствует номер абонента
crcПодпись запросаMd5 контрольная сумма,формирование описывается в пункте "Подпись запросов"Да
ext_idИдентификатор подписки на стороне партнера, будет возвращен при редиректе абонентаСтрока, до 45 символовНет
msisdnНомер абонентаМеждународный формат 79ХХХХХХХХХДа, если отсутствует IP-адрес

Пример запроса:

http://subscribe.mosbill.ru/begin_subscribe?stream_id=8c1ea140-5318-11e5-a698-005056aafe8c&ip=69.30.231.66&crc=test_partner&ext_id=232

Пример ответа:

66d69022-90b5-4e34-ac8e-a6e7653c6200

2) Метод subscribe. Переадресация абонента на тарификатор.

Выполняется HTTP GET запросом на URL http://subscribe.mosbill.ru/subscribe

Передаваемые параметры:

ПараметрОписаниеФорматОбязательный
tidУникальный идентификатор транзакцииСтрока, до 255 символовДа

Пример запроса:

http://subscribe.mosbill.ru/subscribe?tid=66d69022-90b5-4e34-ac8e-a6e7653c6200

Результатом будет переадресация на Landing page.

3) Подключение подписки по прямой ссылке

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

Передаваемые параметры:

ПараметрОписаниеФорматОбязательный
stream_idИдентификатор потокаСтрока, до 40 символовДа
tmplИдентификатор шаблона лэндингаСтрока, до 40 символовНет. Передается только для сервисов, поддерживающих мультилэндинг. Уточняйте в техподдержке.

Пример запроса:

http://subscribe.mosbill.ru/ext/subscribe?stream_id=8c1ea140-5318-11e5-a698-005056aafe8c

4) Переадресация абонента на back_url

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

Передаваемые параметры:

ПараметрОписаниеФорматОбязательный
msisdnНомер абонентаМеждународный формат 79ХХХХХХХХХДа
Subscribe_ResultРезультат операцииМожет принимать значение 0 или 1Да
ext_idИдентификатор транзакции на стороне ПартнераСтрока, до 45 символовДа

Пример запроса:

5) Метод redirect. Переадресация абонента на урл traffback_url

Выполняется HTTP GET запросом на URL traffback_url

Переадресация абонента на traffback_url, в случае невозможности активации подписки ни на одном из сервисов, настроенных для потока и оператора абонента.

Передаваемые параметры.

ПараметрОписаниеФорматОбязательный
ext_idИдентификатор подписки на стороне партнераСтрока, до 45 символовДа

6) Метод unsubscribe. Закрытие подписки, инициированное партнером.

Выполняется HTTP GET запросом на URL http://subscribe.mosbill.ru/unsubscribe

Передаваемые параметры:

ПараметрОписаниеформатОбязательный
msisdnНомер абонентаМеждународный формат 79ХХХХХХХХХДа, если отсутствует IP-адрес
stream_idИдентификатор потокаСтрока, до 40 символовДа
crcПодпись запросаMd5 контрольная сумма, формирование описано в пункте "Подпись запросов"Да

Пример запроса:

http://subscribe.mosbill.ru/unsubscribe?crc=test_partner&msisdn=79856351936&stream_id=5ddb3262-5604-11e5-a698-005056aafe8c

В ответ партнер получает HTTP код 200.

Подпись запросов

Подпись запросов на подписку и отписку представляет собой контрольную сумму, которая формируется следующим образом:
все передаваемые параметры сортируются по именам параметров в алфавитном порядке и выстраиваются в строку ключ+значение, где + - конкатенация. К полученной строке добавляется секретное слово (Salt) для потока. Таким образом, для параметров b=1&a=2&c=3 и Salt qwerty, crc будет md5('a2b1c3qwerty')

Уведомление Партнера о событиях

Выполняется HTTP POST запросом на notification_url

Данные передаются в формате xml.

Для каждого события (Активация подписки, Тарификация, Неуспешная тарификация, Отписка) высылается отдельное уведомление.

Передаваемые параметры:

ПараметрОписаниеФормат
actionТип событияМожет принимать значения SUBSCRIBE(активация подписки),
PROLONG(тарификация),
FAIL(неуспешная тарификация)
UNSUBSCRIBE(отписка)
notify_idУникальный идентификатор уведомления.Позволяет исключить повторную обработку уведомления в случае переотправкиСтрока, до 40 символов
timestampМетка времени событияtimestamp
partner_shareРазмер отчисления партнера по конкретному событиюЧисло, разделитель целой и дробной части - точка
write_offСумма, списанная с абонентаЧисло, разделитель целой и дробной части - точка
subscription_idУникальный идентификатор подписки на стороне тарификатораСтрока, до 40 симоволов
ext_idИдентификатор подписки на стороне Партнера, переданный ранее при вызове метода begin_subscribeСтрока, до 45 символов
service_idИдентификатор сервиса на стороне тарификатора,на который в итоге подписался абонент.Строка, до 40 символов
stream_idИдентификатор ПотокаСтрока, до 40 символов
msisdnНомер абонентаМеждународный формат 79ХХХХХХХХХ
operator_groupГруппа оператора абонентаЧисло.Может принимать значения для Билайн=2,Мегафон=3,МТС=4,Tele2=9

Примеры нотификации:

XML

			<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
			<partnerNotify>
				<notify_id>c17e8ce3-443d-4535-ab05-2c4889262e55</notify_id>
				<action>PROLONG</action>
				<subscription_id>74ab51c6-8656-4ea2-ba1e-c60c5239324d</subscription_id>
				<tid>25547b43-3db7-4f52-bc71-a3a730657b6a</tid>
				<ext_id>44202</ext_id>
				<service_id>31f6f1f7-5146-11e5-a698-005056aafe8c</service_id>
				<stream_id>252770a2-7346-11e5-a698-005056aafe8c</stream_id>
				<operator_group>4</operator_group>
				<msisdn>79886316813</msisdn>
				<write_off>20</write_off>
				<partner_share>4.585</partner_share>
				<timestamp>1447755683</timestamp>
			</partnerNotify>
	
API разовый клик

ОПРЕДЕЛЕНИЯ

РАЗОВЫЙ КЛИК – услуга, подразумевающая единовременное списание фиксированной суммы денежных средств и предоставляющая доступ к определенному контенту на весь период действия услуги.

ПОТОК – гибко настраиваемый субаккаунт партнера, предназначенный для выделения трафика определенной категории (тематика трафика, источник и т.д).

ТАРИФИКАТОР – комплекс оборудования и ПО Mosbill, осуществляющий взаимодействие с оператором в течении всего жизненного цикла подписки.

СЕРВИС – Согласованная с оператором витрина, предоставляющая абоненту оригинальный контент на платной основе.

LANDING – принадлежащая оператору страница подтверждения согласия с подключением услуги и списанием денежных средств, кастомизированная в соответствии с тематикой сервиса.

РОТАЦИЯ – механизм, позволяющий предложить абоненту альтернативный Landing, в случае отказа от подписки, либо ошибки на стороне Оператора.

TRAFFBACK_URL – url, задаваемый для переадресации абонента в случае невозможности подписки абонента на основной и альтернативный Landing.

BACKURL – url, задаваемый для каждого сервиса, для переадресации абонента в случае успешного подключения подписки.

NOTIFICATION_URL - url обработчика уведомлений на стороне партнера.

СЦЕНАРИЙ РАЗОВОГО КЛИКА

Для инициализации списания Партнер вызывает метод begin_subscribe. В ответ тарификатор отдает уникальный идентификатор операции tid.

Получив идентификатор, партнер переадресует абонента на тарификатор, добавляя GET параметр, содержащий полученный ранее tid.

Тарификатор осуществляет переадресацию абонента на лэндинговую страницу Оператора, где абонент либо подтверждает свое согласие с услугой, либо отказ от нее.

После подтверждения абонентом согласия с услугой происходит переадресация абонента на BACKURL (по требованиям Оператора, абонент должен быть переадресован на страницу с контентом той тематики, на которую он подписался), а на обработчик партнера поступает уведомление о подключении услуги и списании денежных средств.

Важно понимать, что уведомление и переадресация абонента не связанные события. Уведомление может поступить как раньше чем произойдет переадресация абонента так и позже этого.

В случае отказа абонента, или невозможности подписки на стороне Оператора или тарификатора по ряду причин, тарификатор производит переадресацию абонента на URL, заданный Партнером для traffback_url.

При наличии в настройках Потока альтернативных лэндингов, тарификатор при отказе абонента или невозможности подписки на основной лэндинг, производит переадресацию абонента на альтернативные landing page, настроенные для потока. Если ни на одном из доступных landing page подписка не оформляется, тарификатор переадресует абонента на traffback_url.

ОПИСАНИЕ МЕТОДОВ

Метод begin_subscribe. Получение идентификатора транзакции.

Выполняется HTTP GET запросом на URL http://suscribe.mosbill.ru/begin_subscribe

Передаваемые параметры:

ПараметрОписаниеОбязательный
stream_idИдентификатор потокада
ipIP-адрес абонентада, если отсутствует номер абонента
crcmd5 контрольная суммада
ext_idИдентификатор транзакции на стороне партнеранет
msisdnНомер абонентада, если отсутствует IP-адрес

Пример запроса:

http://subscribe.mosbill.ru/begin_subscribe?streamid=8c1ea140-5318-11e5-a698-005056aafe8c&ip=69.30.231.66&crc=test_partner&ext_id=232

Пример ответа:

66d69022-90b5-4e34-ac8e-a6e7653c6200

Метод subscribe. Переадресация абонента на тарификатор.

Выполняется HTTP GET запросом на URL http://suscribe.mosbill.ru/subscribe

Передаваемые параметры:

ПараметрОписаниеОбязательный
tidУникальный идентификатор транзакциида

Пример запроса:

http://subscribe.mosbill.ru/subscribe?tid=66d69022-90b5-4e34-ac8e-a6e7653c6200

В ответ партнер получает HTTP код 302.

В заголовке Location будет ссылка на Landing page.

Метод redirect. Переадресация абонента на урл traffback_url

Выполняется HTTP GET запросом на URL traffback_url

Переадресация абонента на traffback_url, в случае невозможности подключения сервисов, настроенных для потока.

Переадресация осуществляется без каких-либо GET параметров.

Метод unsubscribe. Закрытие подписки, инициированное партнером.

Выполняется HTTP GET запросом на URL http://suscribe.mosbill.ru/unsubscribe

Передаваемые параметры:

ПараметрОписаниеОбязательный
msisdnНомер абонентада, если отсутствует IP-адрес
service_idИдентификатор сервиса, на который подписан абонентда
stream_idИдентификатор потокада
crcmd5 контрольная суммада

Пример запроса:

http://subscribe.mosbill.ru/unsubscribe?crc=test_partner&msisdn=79856351936&serviceid=86c46ce6-516a-11e5-a698-005056aafe8c
&streamid=5ddb3262-5604-11e5-a698-005056aafe8c

В ответ партнер получает HTTP код 200.

Уведомление Партнера о событиях

Выполняется HTTP POST запросом на notification_url

Данные передаются в формате xml.

Для каждого события высылается отдельное уведомление.

Передаваемые параметры:

ПараметрОписание
typeТип события. Может принимать значения subscribe,prolong и close
notify_idУникальный идентификатор уведомления.Позволяет исключить повторную обработку уведомления в случае переотправки
timestampМетка времени события
partner_shareРазмер отчисления партнера по конкретному событию
write_offСумма списанная с абонента
subscription_idУникальный идентификатор подписки на стороне тарификатора
ext_idПартнерский идентификатор подписки, переданный ранее при вызове метода begin_subscribe
service_idИдентификатор сервиса на стороне тарификатора,на который подписался абонент.
stream_idИдентификатор Потока
msisdnНомер абонента в международном формате
regionИдентификатор региона абонента
operatorНазвание оператора абонента

Примеры нотификации:

XML

{"event":{"type":"PROLONG","notify_id":"c12e3521-5799-11e5-a221-00259057bc07",
	"timestamp":1441879352,"partner_share":"5.00","write_off":"20.00","subscription_id":
	"73a2d437-579a-11e5-a221-00259057bc07","ext_id":"7eaa80b0-579a-11e5-a221-00259057bc07","service_id":"55f155383f65f",
    "stream_id":"55f155383f69a","msisdn":
	"71111111111","region":"123","operator":"mts"}}
Правила оформления сайтов

ТРЕБОВАНИЯ К ОФОРМЛЕНИЮ И ФУНКЦИОНАЛУ САЙТА:

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

На сайте должны быть указаны корректные префиксы отписки (выдаются техподдержкой) в разделах: Стоимость услуги(для МТС), Правила подписки на контент, Получить контент, Управление подпиской на контент, Футер. Префиксы отписки по МТС и Теле2 указываются с пробелом после слова СТОП, по оператору Билайн и Мегафон – БЕЗ пробела.

Для сайтов с эротическим контентом требуется размещать на сайте значок 18+ либо надпись "запрещено для детей". Значок/надпись необходимо размещать в верхней части сайта.

На сайте - в оферте, футере, разделе "Управление подпиской на контент" должен быть указан телефон центра поддержки абонентов 8-800-234-05-34 и e-mail: claim@mosbill.ru

Текст основных полей страниц сайта, текст на кнопках и ссылках должен быть контрастным по отношению к фону. Ссылки в футере должны быть подчеркнуты

Кнопка "Получить контент" должна присутствовать на всех страницах сайта

В футере – должны присутствовать следующие ссылки – "Получить контент", "Управление подпиской на контент", "Правила подписки на контент", "Стоимость услуги"(для оператора МТС). При наличии футера для нескольких операторов – в конце каждой фразы добавляется – «для абонентов <Оператора>». Текст футера – должен быть контрастным по отношению к фону. Величина шрифта – не менее 10pt. Межстрочный интервал должен быть такой, чтобы ни строки ни ссылки не сливались.

Тексты основных полей, футера и Правил – заполняются по шаблонам, представленным в разделе "Скачать".

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

На сайтах, предоставляющих файлы для скачивания, для пользователей IOS добавляется фраза: "Сайт доступен только для пользователей сетей мобильного интернета. При оформлении подписки пользователям устройств Apple Iphone предоставляются ссылки для скачивания файлов. Владельцы Apple Iphone могут открывать файлы при помощи стандартных приложений, установленных из Appstore.

На сайтах с музыкой и роликами – внизу перед футером должна присутствовать фраза: «Весь контент на сайте исключительно для ознакомления».

КОНТЕНТ И ФУНКЦИОНАЛ:

Сайт с контентной услугой должен содержать не менее 120-150 единиц контента.

Сайт по умолчанию должен блокировать доступ к контенту, в том числе и при входе с WEB. Для тестов и проверки контента оператором - партнер предоставляет логин для тестового входа на сайт.

На момент отправки сайта Оператору на согласование сайт должен обеспечивать переход мобильного абонента на лэндинговую страницу.

При нажатии кнопки Отмена на лэндинге – абонент должен быть переадресован обратно на сайт. При нажатии на лэндинговой странице кнопки подтверждения – также должен происходить возврат абонента на сайт соответствующей контентной услуги. При этом абонент получает доступ к Контенту.

Должен работать функционал раздела "Получить Контент". При наличии подписки – после ввода номера абонент получает доступ к контенту, при отсутствии подписки – сайт выдает сообщение «Указанный номер не найден».

Должен работать функционал раздела "Управление подпиской на контент". При заполнении номера в форму отписки и нажатии кнопки "Отписаться" сайт выдает сообщение: «Подписка отключена», при отсутствии номера в базе сайт выдает сообщение: «У Вас нет Подписок на Контент».

Нажатие на логотип – должно вести на главную страницу.

Если на сайте реализовано несколько разделов – обязательны должны присутствовать кнопки для навигации - "Вперед", "Назад".

Если на сайте реализована функция Поиска – она должен работать корректно.

При отправке SMS с кодом отписки, указанным на сайте, подписка должна отключиться, абонент должен получить смс об отключении подписки.

ОБРАЗЦЫ ФУТЕРОВ>

ОПЕРАТОР МТС

Стоимость услуги для абонентов МТС
Правила подписки на контент для абонентов МТС
Управление подпиской на контент для абонентов МТС
Получить контент
Стоимость услуги составляет 20 рублей с НДС за 1 календарный день для абонентов ПАО "МТС". С размером стоимости услуги и порядком ее списания можно ознакомиться на cайте ПАО «МТС» www.mts.ru в разделе «Услуги по коротким номерам», введя короткий номер или идентификатор услуги в строке поиска,а также позвонив по единому номеру 88002500890. Для отказа от предоставления Подписки на Контент отправьте смс-сообщение с текстом СТОП 20014 на номер 772370 (смс бесплатно в домашнем регионе) или наберите ussd-команду *152*22#вызов (бесплатно). Услуги предоставляются ООО «Стрим» Контакты службы технической поддержки 8-800-234-0534, claim@mosbill.ru

ОПЕРАТОР БИЛАЙН

Правила подписки на контент
Управление подпиской на контент
Получить контент
Стоимость доступа составляет 20.00 рублей (включая НДС) за 1 день для абонентов ОАО «ВымпелКом»; Продление доступа происходит автоматически, посредством подписки. Для отказа от предоставления Подписки на услугу отправьте SMS-сообщение со словом СТОП33333 на номер XXXX для абонентов ОАО "ВымпелКом" сообщение бесплатно в домашнем регионе; Либо воспользуйтесь формой управления подпиской. Контакты службы поддержки: claim@mosbill.ru, 8-800-234-05-34 (звонок бесплатный).

ОПЕРАТОР ТЕЛЕ2

Правила подписки на контент
Управление подпиской на контент
Получить контент
Стоимость услуги: 20 руб. с НДС в сутки для абонентов Теле2. Услуга: Доступ к подписке «XXXXXX.ru». Нажатием кнопки «Подтвердить» вы осуществляете заказ доступа к подписке «XXXXXX.ru», подтверждаете ознакомление и согласие с «Правилами предоставления услуги». Услуга оказывается ООО «XXXXX», ОГРН 111222333444, http://xxx.com/. Информация для абонентов: тел. +8 (800) 234-05-34 (круглосуточно), claim@mosbill.ru. Списание будет производиться с Вашего лицевого счета. GPRS-трафик оплачивается в соответствии с Вашим тарифным планом.

ОФОРМЛЕНИЕ ЛЭНДИНГА:

Не допускается скроллинг страницы LP (необходимость пролистывания страницы для просмотра всех её элементов. LP должен помещаться на один экран 320x480 в полном объёме.

Текст футера должен быть достаточно контрастным по отношению к фону. Ссылки в футере должны быть подчеркнутыми.

Обязательно наличие кнопки "Отмена". Она должна быть достаточно контрастной по отношению к фону.

Текст кнопки подтверждения выбирается из допустимо возможных (см. выдержки из Правил Операторов).

Кнопка на лэндинговой странице не должна быть слишком сильно закруглена так, чтобы отсутствовала кликабельная прямоугольная область вокруг нее и возможность подтвердить подписку, нажав не на саму кнопку, а на область рядом.

ВЕРСТКИ ЛЭНДИНГОВ.

Для оператора МТС - партнер готовит верстку по шаблону, предоставляемому оператором, строго придерживаясь структуры файлов в архиве а также макет готового лэндинга.

Для оператора Билайн - партнер готовит архив, содержащий фоновый тизер, макет лэндинга и текстовый документ с описанием атрибутов лэндинга по предоставляемому оператором шаблону.

Для оператора Теле2 - лэндинг находится на сайте с контентом, партнер предоставляет скриншот-макет для утверждения оператором.

Для оператора Мегафон - Zip архив должен содержать HTML страницу, изображения, файлы стилей. При этом все файлы должны располагаться на одном уровне, то есть НЕ размещены по поддиректориям css, imgs. Архив не должен превышать размер 10mb.

Скачать

Техническая документация

Документация по согласованию собственного сайта

  • Образец оферты Билайн
  • Образец оферты МТС
  • Образец оферты Теле2