SmsCoin Instructions

**Это старая версия документа.** ----

====== Техническое описание услуги «Подписка с вводом номера». Сотовый оператор “Megafon” ====== ===== 1. Общее ===== Логика активации услуги “Подписка с вводом номера” путем авторизации номера телефона по вводу уникального кода предназначена для тех случаев, когда по тем или иным причинам реализация другой логики невозможна. ===== 2. Терминология ===== **Подписка** — абонемент на использование услуги. **Код активации подписки** — уникальный набор символов, высылаемый абоненту на мобильный телефон при заказе услуги «Подписка с вводом номера» для ее активации. **Ребилл** — платеж за услугу «Подписка с вводом номера», взымаемый со счета мобильного телефона пользователя по истечении активного периода. Продолжительность активного периода определяет владелец сайта, предоставляющий услугу. ===== 3. Описание работы ===== - Перед тем, как перейти на страницу заказа услуги “Подписка с вводом номера”, пользователь получает полную информацию об услуге в виде оферты.\\ - После прочтения оферты((Необходимо получить однозначное согласие абонента с условиями оферты, добавив чекбокс «Я согласен с условиями услуги» в форме ввода номера или в форме ввода пароля.)), абонент должен с ней согласиться, ввести свой номер телефона в соответствующем поле и нажать “Продолжить”, перейдя на страницу “создания подписки” (шлюз сотового оператора) “Мегафон”.\\ - На странице “создания подписки” пользователь вводит капчу и ожидает смс сообщение с паролем.\\ - После активации услуги пользователь переадресовывается на сайт партнера.\\ - Абонент вводит полученный от нас по смс код или номер телефона, тем самым активируя услугу. ===== 4. Алгоритм реализации ===== - Определение, какому сотовому оператору принадлежит номер. Определение происходит на стороне партнера. - В случае успеха необходимо выполнить GET - запрос вида «create». При этом к запросу «create» нужно добавить два дополнительных параметра: * web_aware=1 - активирует вариант подписок с переходом на шлюз оператора; * return_url - адрес вашего сайта, на который переходит абонент со шлюза оплаты сотового оператора после завершения операции. **2.1 Создание подписки** **2.1.1 URL** Предоставляется в момент создания сервиса **2.1.2 Характеристики** ^ Параметры ^ Тип ^ Описание ^ | command | text | Устанавливается параметр 'create' | | web_aware | int | 1 — разрешить подписки через шлюз сотового оператора. | | return_url | string | Скрипт, на который будет осуществлен возврат со шлюза оплаты | | phone | varchar(16) | Номер абонента в международном формате (без + или 00) | | ip | varchar(15) | IP-адрес абонента который ввёл номер (используется для защиты от фрода). | | limit_ip | int | отличное от нуля — лимит активаций подписок с одного IP-адреса.отсутствует — по умолчанию 10 | | limit_phone | int | отличное от нуля — лимит активных подписок для указанного номера телефона. отсутствует — по умолчанию 10 | | sid | int | ID услуги (предоставляется отдельно) | **2.2 Формат ответа** Как правило, XML-ответ выглядит следующим образом. <file><response> <code>0</code> <desc>code_created</desc> <extra>123</extra> </response></file> **2.2.1 Возможные ответы системы** Как правило, XML-ответ выглядит следующим образом. ^ Тип ^ Статус ^ Описание ^ Пояснение ^ | OK | 0 | code_created | Пароль создан | | error | 6 | too_much_subs_for_ip | Превышен лимит подписок с одного IP | | error | 4 | too_much_subs_for_phone | Превышен лимит подписок с одного номера | | error | 3 | phone_have_active_subs_already | На номере есть активная подписка | | error | 2 | phone_blacklisted | Номер в черном списке | | error | 1 | subs_not_supported_for_provider | Данный сотовый оператор не поддерживается | 3. В ответ на этот запрос, наш сервер возвращает временную ссылку на шлюз оплаты сгенерированную Мегафоном в параметре <extra> </extra>. Поскольку данная ссылка содержит HTML сущности, перед перенаправлением ее необходимо декодировать функцией html_entity_decode().\\ 4. Код доступа к вашему ресурсу мы генерируем на своей стороне по факту успешного перехода абонента со шлюза Мегафона на ваш return_url. Код действует только в период пока подписка активна. Если абонент отписался – код не должен быть активен.\\ ===== 5. Переход на return_url ===== При переходе абонента на return_url вашего сайта, возможно два варианта «подписка создана успешно» и «ошибка при создании подписки» \\ **5.1 Подписка создана успешно** При удачно созданной подписке абонент редиректится на return_url с дополнительными параметрами (см. таблицу) ^ Параметр ^ Описание ^ | phone | Номер абонента | | subscription_id | ID подписки абонента | | s_id | ID сервиса подписок | | hash_sign | Результат работы функции: md5(':-:'.subscription_id.':-:'.s_id.':-:'.phone) | | status | Данный параметр всегда равен 0 | После чего мы отправляем абоненту код доступа на Status URL с дополнительными параметрами (см. таблицу) ^ Параметр ^ Описание ^ | phone | Номер абонента | | subscription_id | ID подписки абонента | | subs_sid | ID сервиса подписок | | sign | Результат работы функции: md5(':-:'.subscription_id.':-:'.s_id.':-:'.phone) | | status | Равен start | | megafon_subs_code | Сгенерированный нами и отправленный абоненту код доступа | После получения этих данных на ваш Status URL вы предоставляете доступ к сайту по полученному коду доступа или по номеру телефона на странице указанной в return_url.\\ status=start может быть передан как в момент перехода на return url, так и немного позже, данное действие зависит от сотового оператора. **5.2 Ошибка при создании подписки** В данном случае, при редиректе на return_url передаются два дополнительных параметра: phone и status, где параметр status всегда равен 1, что означает:\\ **1 – неуспешная подписка** 
 ===== 6. После активации подписки начинаются ежедневные ребиллы: ===== Вызывается скрипт, прописанный в Result URL. На обработчик передается все параметры описанные по адресу http://smscoin.com/info/smstransit-tech/ и параметр subscription_id. Обратите внимание на то, что параметр billing всегда равен МО ( billing = MO) ===== 7. Инструкция по отписке абонента. ===== (персональный код отписки) выдаётся при активации подписки на стороне оператора Мегафон. Формат: «стоп ID» на номер 5051 После отмены подписки на Status URL передается параметр status=stop, а также параметры subscription_id и subs_sid. ===== 8. Схема "Активации подписки "Мегафон". ===== {{:ru:subs2:screen_shot_2014-01-31_at_17.06.06.png?200|Схема "Активации подписки "Мегафон"}}