SmsCoin Instructions

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

--- ru:subs8:start [2013/11/14 11:42]
smscoin
+++ ru:subs8:start [2020/08/21 14:16] (текущий)
@@ Строка 51: / Строка 51: @@
 \\
 Для создания авторизационной записи нужно вызвать следущий URL: \\
-\\[предоставляется в момент создания сервиса]
+[предоставляется в момент создания сервиса]
 \\
 \\
@@ Строка 64: / Строка 64: @@
 ** 4.1.1 Ответ сервера, в случае успеха (формат JSON): **
-{{{\\
+   {{{
-{
+   {
-   "auth_id": UUID
+      "auth_id": UUID
-}\\
+   }
-}}}
+   }}}
 **4.2 Получение информации об авторизационной записи**
@@ Строка 83: / Строка 83: @@
 ** 4.2.1 Ответ сервера, в случае успеха (формат JSON): **
-{{{\\
+   {{{
-{
+   {
-   "active": true,
+      "active": true,
-   "auth_id": "389eb6cd59774e869a79dd2b5ddc70e3",
+      "auth_id": "389eb6cd59774e869a79dd2b5ddc70e3",
-   "create_date": "2012-09-09T17:35:30.705322",
+      "create_date": "2012-09-09T17:35:30.705322",
-   "expire_date": "2012-10-09T17:35:30.705322", "msisdn": "987654321"
+      "expire_date": "2012-10-09T17:35:30.705322", "msisdn": "987654321"
-}\\
+   }
-}}}
+   }}}
 Поля ответа:
@@ Строка 116: / Строка 116: @@
 В случае успеха, сервер выдает ответ:\\
-{{{\\
+   {{{
-{
+   {
-   "active": true,
+      "active": true,
-   "auth_id": UUID
+      "auth_id": UUID
-}\\
+   }
-}}}
+   }}}
-Где UUID - идентификатор авторизации (используется при тарификации или для проверки авторизационной записи).
+Где UUID - идентификатор авторизации (используется при тарификации или для проверки авторизационной записи).\\
 Активация допускается только один раз. При повторной попытке с теми же данными сервер вернёт ответ с кодом 400 и телом "Password not found or inactive".
+**4.4 Деавторизация абонента**
+Для блокировки PBC для абонента, вызывается URL:\\
+\\
+[предоставляется в момент создания сервиса]\\
+\\
+с параметрами:
+^ Параметры       ^ Тип        ^ Описание           ^
+| msisdn    | string(32)     | MSISDN абонента        |
+| ip    | string(32)     | IP-адрес абонента, с которого он потребовал отключение PBC        |
+| reason    | string(255)     | текст, объясняющий отмену авторизации. Например, "требование пользователя". Необязательное поле.        |
+| project    | string(64)     | идентификатор проекта, например, "p_someproject"        |
+| project_pass word    | string(64)     | пароль проекта, например, "phahfaeshaCh8joh"        |
+В случае успеха, сервер выдает ответ:\\
+   {{{
+   {
+      "blocked": true,
+   }
+   }}}
+====== 5. Тарификация абонентов ======
+Тарификация инициируется абонентом при нажатии кнопки "тарификация" на сайте партнёра. Сайт партнёра в этот момент передает к нам запрос вида:\\
+\\
+[предоставляется в момент создания сервиса] \\
+\\
+с параметрами:
+^ Параметры       ^ Тип        ^ Описание           ^
+| msisdn    | string(32)     | MSISDN абонента        |
+| ip    | string(32)     | IP-адрес абонента, с которого он ввёл пароль       |
+| rate    | string(64)     | идентификатор тарифа. Доступные идентификаторы тарифов указаны в приложении.        |
+| price    | string(16)     | тоимость (в виде числа с плавающей запятой) тарифа в локальной валюте, без НДС. В запросе может быть указан либо идентификатор тарифа, либо стоимость, но не оба одновременно.        |
+| project    | string(64)     | идентификатор проекта, например, "p_someproject"        |
+| project_pass word    | string(64)     | пароль проекта, например, "phahfaeshaCh8joh"        |
+| project_id    | string(64)     | идентификатор запроса со стороны проекта, для защиты от повторных запросов. Опционально. Идентификатор передаётся партнёру при отправке статуса оплаты (см. ниже)       |
+В случае успеха, сервер возвращает id транзакции:\\
+   {{{
+   {
+      "transaction_id": UUID
+   }
+   }}}
+Этот id будет использован при обработке статуса (см. ниже).
+====== 6. Статус тарификации ======
+После получения статуса тарификации, сервер вызывает ваш Status URL, передавая на него следующие параметры (в GET или POST-запросе):
+^ Параметры       ^ Тип        ^ Описание           ^
+| project    | string(64)     | идентификатор проекта, к которому относится транзакция        |
+| transaction_ id    | UUID     | идентификатор транзакции, полученный при тарификации        |
+| status    | enum('fail', 'ok')     | статус тарификации - ''fail'' или ''ok'': 1. ok - абонент был успешно протарифицирован, ему может быть предоставлена запрошенная услуга 2. fail - тарификация не прошла по какой-либо причине. Транзакция не будет оплачена, услугу предоставлять нельзя.        |
+| rate    | string(64)     | идентификатор тарифа        |
+| operator    | string(64)     | код сотового оператора абонента        |
+| cost_local    | float     | стоимость транзакции для абонента (в локальной валюте страны абонента)        |
+| cost_usd    | float     | стоимость в USD по текущему курсу системы       |
+| profit    | float     | процент заработка партнёра с этой транзакции       |
+| msisdn    | string(32)    | номер телефона абонента        |
+| project_id    | string(64)    | идентификатор запроса со стороны проекта, для защиты от повторных запросов. Опционально. Идентификатор передаётся партнёру при отправке статуса оплаты (см. ниже)        |
+====== 7. Схема услуги "Pay-By-Click" =====
+{{:ru:subs8:снимок_экрана_2013-11-14_в_13.03.40.png?200|}}

SmsCoin Instructions

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

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

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