Монетизация#
Warning
На данный момент мы можем принимать платежи только от абонентов Теле 2.
In-App платежи#
Для интеграции in-app платежей можно воспользоваться SDK ИгроСферы. Валидность платежей можно проверить с помощью серверного API Платежей.
Процедура работы монетизации#
Платежи инициируются пользователями с их устройств из приложений через SDK ИгроСферы, и могут быть проверены на сервере посредством серверного API Платежей.
Сущности#
| Имя | Описание |
|---|---|
| Заказ | Заказ в системе, имеет несколько статусов: |
| Продукт | Продукт, который может быть приобретен пользователем. Может иметь несколько ценовых категорий. |
Статусы заказа#
stateDiagram-v2
[*] --> CREATED
CREATED --> CONFIRMED
CREATED --> PAYMENT_CANCELED
CREATED --> OVERDUE
CREATED --> FAILED
CONFIRMED --> PAYMENT_CREATED
PAYMENT_CREATED --> PAYED
PAYMENT_CREATED --> PAYMENT_CANCELED
PAYMENT_CANCELED --> CANCELED
PAYMENT_CREATED --> OVERDUE
PAYMENT_CREATED --> FAILED
PAYED --> PAYMENT_CANCELED
PAYED --> CONSUMED
CONFIRMED --> PAYMENT_CANCELED
CONFIRMED --> OVERDUE
CONFIRMED --> FAILED
CONSUMED --> [*]
FAILED --> [*]
OVERDUE --> [*]
CANCELED --> [*]| Статус | Конечный | Описание |
|---|---|---|
CREATED |
Нет | Заказ создан в системе |
CONFIRMED |
Нет | Подтвержден системой, запущен в обработку |
PAYMENT_CREATED |
Нет | Платеж создан в мобильном банке |
PAYED |
Нет | Платеж прошел в банке |
CONSUMED |
Да | Потреблен (подтверждено получение на клиентском приложении) |
OVERDUE |
Да | Прошло максимальное время обработки заказа, при этом он не был оплачен |
FAILED |
Да | Ошибка платежа |
PAYMENT_CANCELED |
Нет | Платеж отменяется в мобильном банке |
CANCELED |
Да | Заказ отменен, деньги возвращены клиенту |
Схема и процедура работы c In-App платежами#
sequenceDiagram
autonumber
actor User
participant SDK as App and SDK
participant Marketplace
participant BillingAPI
participant DeveloperServer
User->>SDK: Хочет купить in-app продукт
SDK->>Marketplace: Запрашивает токен доступа к API для данного пользователя
Marketplace->>SDK: Токен доступа к API
SDK->>BillingAPI: Запрос на создание заказа
loop Ожидание событий заказа:
SDK->>BillingAPI: Polling
BillingAPI->>SDK: Статус заказа
end
Note over SDK, BillingAPI: Получен успешный статус (PAYED)
SDK->>DeveloperServer: orderId и orderToken
DeveloperServer->>BillingAPI: Проверка валидности orderId и orderToken
BillingAPI->>DeveloperServer: OK
DeveloperServer->>DeveloperServer: Зафиксировать владение пользователя товаром
DeveloperServer->>SDK: OK
SDK->>BillingAPI: Подтверждение потребления заказа
SDK->>User: Выдает товар