SmsCoin Instructions

====== Техническое описание услуги «Псевдо подписка с вводом номера» ====== ====== 1. Общее ====== Логика активации услуги “Псевдо подписка с вводом номера” путем авторизации номера телефона по вводу уникального кода предназначена для тех случаев, когда обычные виды подписок не поддерживаются оператором. Данный вид подписок можно организовать со всеми сотовыми операторами Российской Федерации кроме Теле-2. Внимание! Начиная с 01/08/13 мы более не подключаем данный вид подписок на сотовом операторе Билайн.. ====== 2. Терминология ====== **Псевдо подписка** — абонемент на использование услуги. **Код активации псевдо подписки** — уникальный набор символов, высылаемый абоненту на мобильный телефон при заказе услуги «Псевдо подписка с вводом номера» для ее активации. **Ребилл** — платеж за услугу «Псевдо подписка с вводом номера», взимаемый со счета мобильного телефона пользователя по истечении активного периода. Продолжительность активного периода определяет владелец сайта, предоставляющего услугу. ====== 3. Описание работы ====== 1. Перед тем, как перейти на страницу заказа услуги “Псевдо подписка с вводом номера”, пользователь получает полную информацию об услуге в виде оферты . 2. После прочтения оферты((Необходимо получить однозначное согласие абонента с условиями оферты, добавив чекбокс «Я согласен с условиями услуги» в форме ввода номера или в форме ввода пароля.)), абонент должен с ней согласиться, ввести свой номер телефона в соответствующем поле и нажать “Продолжить”. 3. Если для введенного телефонного номера услуга доступна, пользователю отправляется пригласительное смс-сообщение. * Если для конкретного номера или IP пользователя услуга недоступна по причине превышения лимитов, следует вывести сообщение об ошибке и предоставить альтернативный способ оплаты(((Альтернативным способом оплаты может быть активация услуги путем отправки смс-сообщения (платного или бесплатного) на короткий номер.)). 4. Абонент должен следовать инструкции в пригласительном смс. Путем ответа на полученное пригласительно сообщение. 5. При отправке ответного смс пользователь оплачивает услугу и тем самым активирует ее. 6. По окончании срока действия услуги пользователь получает смс с предложением отправить ответное смс для продления псевдо подписки. ====== 4. Алгоритм реализации ====== 1. Определение, какому сотовому оператору принадлежит номер. Определение происходит на стороне партнера. 2. В случае успеха необходимо выполнить GET - запрос вида «create». В ответ пользователь получит пригласительно смс сообщение. При этом в качестве дополнительного параметра в запросе передается pseudo_sc, который задает стоимость услуги (тариф), параметр pseudo_text, который задает текст смс-сообщения, которое будет передано пользователю и pseudo_no_pin=1. **2.1 Создание подписки** **2.1.1 URL** [предоставляется в момент создания сервиса] **2.1.2 Характеристики** ^ Параметры ^ Тип ^ Описание ^ | command | text | Устанавливается параметр 'create' | | pseudo_sc | int | Короткий номер, определяющий стоимость подписки | | pseudo_text | text | Текст пригласительного сообщения | | pseudo_no_pin | int | Параметр должен быть равен единице. | | phone | varchar(16) | Номер абонента в международном формате без + или 00) | | ip | varchar(15) | IP-адрес абонента который ввёл номер (используется для защиты от фрода). | | limit_ip | int | отличное от нуля — лимит активаций подписок с одного IP-адреса.отсутствует — по умолчанию 10 | | limit_phone | int | отличное от нуля — лимит активных подписок для указанного номера телефона. отсутствует — по умолчанию 10 | | sid | text | ID услуги (предоставляется отдельно) | | pseudo_enable | int | Должен быть установлен 1 — активирует схему псевдо. | | pseudo_force | int | 1 — разрешить псевдо подписки для всех операторов (кроме Теле-2). 0 — псевдо будет активировано только для МТС, Билайна и Мегафона | **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. После отправки ответного смс пользователем, псевдо подписка активируется и производится ребилл: * Вызывается скрипт, прописанный в Result URL1. Помимо параметров для услуги смс:транзит, описанных по адресу http://smscoin.com/info/smstransit-tech/, на обработчик приходит параметр subscription_id – уникальный номер подписки для заданного номера телефона, а параметр billing всегда будет равен MO. * Result URL должен вернуть пользователю соответствующий текст смс-сообщения в кодировке UTF-8, согласно первого и последующих ребиллов, в зависимости от условий оператора сотовой связи и стоимости подписки. 4. По окончании срока действия услуги, пользователь получает смс с предложением отправить ответное смс для продления псевдо подписки. * Если пользователь отправляет ответное смс, вновь производится ребилл и псевдо подписка продлевается на следующий период. * Если пользователь хочет деактивировать псевдо подписку, он просто должен игнорировать это сообщение и псевдо подписка аннулируется. {{:ru:subs3:screen_shot_2013-06-11_at_5.20.06_pm.png?200|Схема псевдо подписок }}