Общая информация
Рекомендуем указывать информацию о продолжительности триального периода и стоимости подписки после его окончания в интерфейсе игры.
В случае поступления жалоб от пользователей о недостаточном информировании о схеме работы подписки мы вправе попросить вас внести изменения в интерфейс приложения, или же деактивировать подписку в игре.
Отображает диалог подписки на товар / услугу в приложении. Для успешной подписки серверный callback со стороны разработчика должен подтвердить подписку, иначе она закончится неудачей и подписка не произведется.
В случае успешной подписки с периодичностью, указанной в настройках подписки, пользователь автоматически будет производить оплату товара по подписке по стоимости, которая была установлена разработчиков для данной подписки.
Сигнатура метода
FAPI.invokeUIMethod("showPaymentSubscription", productId, productPrice);| Имя | Требуется | Тип | Описание |
|---|---|---|---|
| productId | Да | String | Id подписки, зарегистрированной в Одноклассников для приложения |
| price | Да | Integer | Цена подписки за один период времени |
Пример вызова
/*
* Пример вызова showPaymentSubscription().
* Внимание! Сервер должен подтвердить факт подписки, чтобы она прошла успешно
*/
function showPaymentSubscription() {
FAPI.invokeUIMethod("showPaymentSubscription", "productId", 10);
}Пример коллбека
Отображает диалог оплаты для конечного продукта. Для успешной оплаты серверный callback со стороны разработчика должен подтвердить оплату, иначе оплата закончится неудачей. После успешного завершения транзакции клиентское приложение получит уведомление «ok», иначе он получит уведомление «error».
Функция API_callback может быть вызвана со следующими параметрами:
Коллбек для случая успешного проведения платежа
method: “showPaymentSubscription”
result: “ok”
data: “ok”
Коллбек для случая отмены платежа
method: “showPaymentSubscription”
result: “error”
data: “cancel”
Добавление новой подписки
Прежде чем приложение сможет вызвать окно подписки для товара с указанным id, эта подписка должна быть зарегистрирована в Одноклассниках.
Для добавления подписки в вашем приложении напишите письмо на почтовый адрес api-support@ok.ru с темой “Подписки в играх: id_приложения” со следующими данными:
| Параметр | Описание | Единица измерения |
|---|---|---|
| Триальный период | Длительность бесплатного периода подписки | Дни, часы, минуты |
| Длительность | Периодичность оплаты подписки | Дни, часы, минуты |
| Стоимость | Цена подписки за один период | ОКи |
| Иконка подписки | Ссылка на иконку подписки в формате 256x256 | |
| productId | Строковый идентификатор подписки в Одноклассниках | |
| Название | Название подписки (1-3 слова). В названии должна отражаться суть подписки | |
| Описание | Краткое описание подписки (1-2 предложения). В описании должно указываться, на какую услугу подписывается пользователь, что он покупает |