SmsCoin Instructions

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

--- ru:subs0:start [2013/06/05 16:07]
admin [2.1 Создание подписки]
+++ ru:subs0:start [2020/08/21 14:16] (текущий)
@@ Строка 25: / Строка 25: @@
   - После прочтения оферты((Необходимо  получить однозначное согласие абонента с условиями оферты, добавив чекбокс «Я согласен с условиями услуги» в форме ввода номера или в форме ввода пароля.)), абонент должен с ней согласиться, ввести свой номер телефона в соответствующем поле и нажать “Продолжить”, перейдя на страницу “создания подписки” (шлюз сотового оператора) “МТС”.
   - На странице “создания подписки”  пользователь вводит капчу и ожидает смс сообщение с паролем.
-  - Абонент вводит полученный код, тем самым активируя услугу.
+  - После активации услуги пользователь переадресовывается на сайт партнера.
-  - После активации услуги пользователь переадресовывается на сайт партнера.
+  - Абонент вводит полученный от нас по смс код или код и номер телефона, тем самым активируя услугу.
+===== 4. Алгоритм реализации =====
-===== 4. Описание работы подписки оператора МТС =====
@@ Строка 38: / Строка 37: @@
   * return_url - адрес вашего сайта, на который переходит абонент со шлюза оплаты сотового оператора после завершения операции.
-==== 2.1 Создание подписки ====
+**2.1 Создание подписки**
-=== 2.1.1  URL ===
+**2.1.1  URL**
 Предоставляется в момент создания сервиса
-=== 2.1.2 Характеристики ===
+**2.1.2 Характеристики**
 ^ Параметры       ^ Тип        ^ Описание           ^
 | command    | text     | Устанавливается параметр 'create'        |
-| web_aware    | int     | 1 — разрешить  подписки через шлюз сотового оператора,0 — деактивация логики подписок через шлюз оплаты .        |
+| web_aware    | int     | 1 — разрешить  подписки через шлюз сотового оператора.        |
 | return_url    | string     | Скрипт, на который будет осуществлен возврат со шлюза оплаты        |
-| phone    | varchar(16)     | Номер абонента в международном формате без + или 00)        |
+| phone    | varchar(16)     | Номер абонента в международном формате (без + или 00)        |
 | ip    | varchar(15)     | IP-адрес абонента который ввёл номер (используется для защиты от фрода).        |
 | limit_ip    | int     | отличное от нуля — лимит активаций подписок с одного IP-адреса.отсутствует — по умолчанию 10       |
@@ Строка 56: / Строка 55: @@
 | sid    | text    | ID услуги (предоставляется отдельно)        |
-=== 2.2 Формат ответа ===
+**2.2 Формат ответа**
 Как правило, XML-ответ выглядит следующим образом.
@@ Строка 66: / Строка 65: @@
 </response></file>
-=== 2.2.1 Возможные ответы системы ===
+**2.2.1 Возможные ответы системы**
 Как правило, XML-ответ выглядит как следующим образом.
@@ Строка 81: / Строка 80: @@
 . В ответ на этот запрос, наш сервер возвращает временную ссылку на шлюз оплаты сгенерированную МТС(-ом) в параметре <code><extra> </extra></code> Поскольку данная ссылка содержит HTML сущности, перед перенаправлением ее необходимо декодировать функцией html_entity_decode().\\
-. Код доступа к вашему ресурсу вы выдаете самостоятельно по факту успешного перехода абонента со шлюза МТС на ваш return_url. Код предоставляется на 30 дней.\\
+. Код доступа к вашему ресурсу мы генерируем на своей стороне по факту успешного перехода абонента со шлюза МТС на ваш 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=start и mts_subs_code=1234 (код доступа сгенерированный нашей системой) на Status URL. После получения этих данных на ваш 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)
+  * Result URL ничего, кроме статуса 200 OK возвращать не должен. Любой текстовый ответ будет игнорироваться.
+===== 7. Отмена подписки. =====
+Пользователь может отказать от подписки путем звонка на номер *152*2# вызов бесплатный.
+После отмены подписки на Status URL передается параметр status=stop, а также параметры subscription_id и subs_sid.
+===== 8. Схема "Активации подписки MTC". =====
-. При переходе абонента на return_url вашего сайта, возможно два варианта «подписка создана успешно» и «ошибка при создании подписки» \\
+{{:ru:subs0:снимок_экрана_2013-11-07_в_12.11.58.png?200|Схема "Активации подписки MTC"}}

SmsCoin Instructions

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

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

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