SmsCoin Instructions

====== Техническое описание услуги «Подписка с вводом номера». Сотовый оператор “Beeline” ====== ===== 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 — разрешить подписки через шлюз сотового оператора,0 — деактивация логики подписок через шлюз оплаты . | | return_url | string | Скрипт, на который будет осуществлен возврат со шлюза оплаты | | phone | varchar(16) | Номер абонента в международном формате (без + или 00) | | ip | varchar(15) | IP-адрес абонента который ввёл номер (требование сотового оператора). | | limit_ip | int | отличное от нуля — лимит активаций подписок с одного IP-адреса.отсутствует — по умолчанию 10 | | limit_phone | int | отличное от нуля — лимит активных подписок для указанного номера телефона. отсутствует — по умолчанию 10 | | sid | text | 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. В ответ на этот запрос, наш сервер возвращает временную ссылку на шлюз оплаты сгенерированную Билайном в параметре <code><extra> </extra></code> Поскольку данная ссылка содержит HTML сущности, перед перенаправлением ее необходимо декодировать функцией html_entity_decode().\\ 4. Код доступа к вашему ресурсу вы выдаете самостоятельно по факту успешного перехода абонента со шлюза Билайн на ваш return_url. Код предоставляется на 30 дней.\\ ===== 5. Переход на return_url ===== При переходе абонента на return_url вашего сайта, возможно два варианта «подписка создана успешно» и «ошибка при создании подписки» Абонент редиректится на return_url с дополнительными параметрами (см. таблицу) ^ Параметр ^ Описание ^ | phone | Номер абонента | | subscription_id | ID подписки абонента (передается при удачно созданной подписке) | | s_id | ID сервиса подписок (передается при удачно созданной подписке) | | status | Может принимать два значения: 1) **reservation** - средства зарезервированы, не финальный статус, требуется ждать start на Status URL. 2) **error** – ошибка, подписка не создана. | | hash_sign | Результат работы функции: md5(':-:'.subscription_id.':-:'.s_id.':-:'.phone) | ===== 6. После активации подписки ежедневные ребиллы начинаются на следующий день (пробный период): ===== * Вызывается скрипт, прописанный в Result URL. На обработчик передается все параметры описанные по адресу http://smscoin.com/info/smstransit-tech/ и параметр subscription_id. Обратите внимание на то, что параметр billing всегда равен МО ( billing = MO) * Result URL ничего, кроме статуса 200 OK возвращать не должен. Любой текстовый ответ будет игнорироваться. ===== 7. Как можно отписаться ===== Пользователь может отказаться от подписки путем отправки смс со словом «стоп» на 9105. После отмены подписки на Status URL передается параметр status=stop, а также параметры subscription_id и subs_sid. ===== 8. Схема "Активации подписки "Билайн". ===== {{:ru:subs1:снимок_экрана_2013-11-20_в_14.20.09.png?200|Схема "Активации подписки "Билайн"}}