Инструменты пользователя
Инструменты сайта
ru:subs8:start
====== Различия ====== Здесь показаны различия между выбранной ревизией и текущей версией данной страницы.
|
ru:subs8:start [2013/11/14 11:23] smscoin |
ru:subs8:start [2020/08/21 14:16] (текущий) |
||
|---|---|---|---|
| Строка 51: | Строка 51: | ||
| \\ | \\ | ||
| Для создания авторизационной записи нужно вызвать следущий URL: \\ | Для создания авторизационной записи нужно вызвать следущий URL: \\ | ||
| - | \\[предоставляется в момент создания сервиса] | + | [предоставляется в момент создания сервиса] |
| \\ | \\ | ||
| \\ | \\ | ||
| Строка 64: | Строка 64: | ||
| ** 4.1.1 Ответ сервера, в случае успеха (формат JSON): ** | ** 4.1.1 Ответ сервера, в случае успеха (формат JSON): ** | ||
| - | {{{\\ | + | {{{ |
| - | { | + | { |
| - | "auth_id": UUID | + | "auth_id": UUID |
| - | }\\ | + | } |
| - | }}} | + | }}} |
| **4.2 Получение информации об авторизационной записи** | **4.2 Получение информации об авторизационной записи** | ||
| Строка 83: | Строка 83: | ||
| ** 4.2.1 Ответ сервера, в случае успеха (формат JSON): ** | ** 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" |
| - | }\\ | + | } |
| - | }}} | + | }}} |
| Поля ответа: | Поля ответа: | ||
| ^ Параметры ^ Тип ^ Описание ^ | ^ Параметры ^ Тип ^ Описание ^ | ||
| - | | command | text | Устанавливается параметр 'create' | | + | | active | boolean | флаг активности авторизационной записи абонента. Абонента можно биллить только пока авторизационная запись активна. | |
| - | | pseudo_sc | int | Короткий номер, определяющий стоимость подписки | | + | | auth_id | UUID | идентификатор авторизационной записи абонента | |
| - | | pseudo_text | text | Текст пригласительного сообщения | | + | | create_date | iso8601 | дата создания авторизационной записи в стандарте ISO-8601 | |
| - | | pseudo_no_pin | int | Параметр должен быть равен единице. | | + | | expire_date | iso8601 | дата окончания действия авторизационной записи в стандарте ISO-8601 | |
| - | | phone | varchar(16) | Номер абонента в международном формате без + или 00) | | + | | msisdn | string(32) | Номер абонента в международном формате без + или 00) | |
| + | |||
| + | **4.3 Подтверждение пароля абонента** | ||
| + | |||
| + | После получения паролем абонента, он вводит его на сайте партнёра, а сервис партнёра выполняет его проверку. URL\\ | ||
| + | \\ | ||
| + | [предоставляется в момент создания сервиса]\\ | ||
| + | \\ | ||
| + | с параметрами: | ||
| + | ^ Параметры ^ Тип ^ Описание ^ | ||
| + | | msisdn | string(32) | MSISDN абонента | | ||
| + | | ip | string(32) | IP-адрес абонента, с которого он ввёл пароль | | ||
| + | | subscriber_p assword | string(16) | пароль, который ввёл абонент | | ||
| + | | project | string(64) | идентификатор проекта, например, "p_someproject" | | ||
| + | | project_pass word | string(64) | пароль проекта, например, "phahfaeshaCh8joh" | | ||
| + | |||
| + | В случае успеха, сервер выдает ответ:\\ | ||
| + | {{{ | ||
| + | { | ||
| + | "active": true, | ||
| + | "auth_id": 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|}} | ||
ru/subs8/start.1384424595.txt.gz · Последние изменения: 2020/08/21 14:12 (внешнее изменение)
Инструменты страницы
За исключением случаев, когда указано иное, содержимое этой вики предоставляется на условиях следующей лицензии: CC Attribution-Share Alike 3.0 Unported
