SmsCoin Instructions

====== Различия ====== Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.

--- ru:subs3:start [2013/06/11 16:02]
admin [3. Описание работы]
+++ ru:subs3:start [2020/08/21 14:16] (текущий)
@@ Строка 6: / Строка 6: @@
 Логика активации услуги “Псевдо подписка с вводом номера” путем авторизации номера телефона  по вводу уникального кода предназначена для тех случаев, когда обычные виды подписок не поддерживаются оператором. Данный вид подписок можно организовать со всеми сотовыми операторами Российской Федерации кроме Теле-2.
+Внимание! Начиная с 01/08/13 мы более не подключаем данный вид подписок на сотовом операторе Билайн..
@@ Строка 28: / Строка 30: @@
 . Если для введенного телефонного номера услуга доступна, пользователю отправляется пригласительное смс-сообщение.
-Если для конкретного номера или IP пользователя услуга недоступна по причине превышения лимитов, следует вывести сообщение об ошибке и предоставить альтернативный способ оплаты(((Альтернативным способом оплаты может быть активация услуги путем отправки смс-сообщения (платного или бесплатного) на короткий номер.)).
+  * Если для конкретного номера или IP пользователя услуга недоступна по причине превышения лимитов, следует вывести сообщение об ошибке и предоставить альтернативный способ оплаты(((Альтернативным способом оплаты может быть активация услуги путем отправки смс-сообщения (платного или бесплатного) на короткий номер.)).
+. Абонент должен следовать инструкции в пригласительном смс. Путем ответа на полученное пригласительно сообщение.
+. При отправке ответного смс пользователь оплачивает услугу и тем самым активирует ее.
+. По окончании срока действия услуги пользователь получает смс с предложением отправить ответное смс для продления псевдо подписки.
+====== 4. Алгоритм реализации ======
+. Определение, какому сотовому оператору принадлежит номер. Определение происходит на стороне партнера.
+. В случае успеха необходимо выполнить 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        | Данный сотовый оператор не поддерживается        |
+. После отправки ответного смс пользователем, псевдо подписка активируется и производится ребилл:
+  * Вызывается скрипт, прописанный в Result URL1. Помимо параметров для услуги смс:транзит, описанных по адресу http://smscoin.com/info/smstransit-tech/, на обработчик приходит параметр  subscription_id – уникальный номер подписки для заданного номера телефона, а  параметр billing всегда будет равен  MO.
+  * Result URL должен вернуть пользователю соответствующий текст смс-сообщения в кодировке UTF-8, согласно первого и последующих ребиллов, в зависимости от  условий оператора сотовой связи и стоимости подписки.
+. По окончании срока действия услуги, пользователь получает смс с предложением отправить ответное смс для продления псевдо подписки.
+  * Если пользователь отправляет ответное смс, вновь производится ребилл и псевдо подписка продлевается на следующий период.
+  * Если пользователь хочет деактивировать псевдо подписку, он просто должен игнорировать это сообщение и псевдо подписка аннулируется.
+{{:ru:subs3:screen_shot_2013-06-11_at_5.20.06_pm.png?200|Схема псевдо подписок }}

SmsCoin Instructions

Инструменты пользователя

Инструменты сайта

Инструменты страницы