Событие при оплате приложения onAppPayment

Выберите инструмент для разработки с AI-агентом:

  • используйте Битрикс24 Вайбкод, чтобы создать приложение для Битрикс24 по описанию задачи без знания языков программирования. Агент напишет код и разместит приложение на сервере без ручной настройки хостинга
  • используйте MCP-сервер, чтобы разрабатывать интеграцию через REST API в своем проекте. Агент будет обращаться к официальной REST-документации

Scope: базовый

Кто может подписаться: любой пользователь

Событие ONAPPPAYMENT вызывается при оплате приложения.

События не будут отправляться в приложение, пока установка не завершена. Проверьте установку приложения

Что получает обработчик

Данные передаются в виде POST-запроса

{
            "event": "ONAPPPAYMENT",
            "data": {
                "CODE": "bitrix.gds_company",
                "VERSION": 1,
                "STATUS": "S",
                "PAYMENT_EXPIRED": "N",
                "DAYS": 28,
                "LANGUAGE_ID": "ru"
            },
            "ts": "1466439714",
            "auth": {
                "domain": "some-domain.bitrix24.ru",
                "server_endpoint": "https://oauth.bitrix24.tech/rest/",
                "client_endpoint": "https://some-domain.bitrix24.ru/rest/",
                "member_id": "a223c6b3710f85df22e9377d6c4f7553"
            }
        }
        

Параметры запроса

Обязательные параметры отмечены *

Название
тип

Описание

event*
string

Символьный код события — ONAPPPAYMENT

data*
object

Данные о платеже.

Структура описана ниже

ts*
timestamp

Дата и время отправки события из очереди

auth*
object

Данные авторизации и Битрикс24.

Структура описана ниже

Параметр data

Название
тип

Описание

CODE*
string

Код приложения

VERSION*
integer

Установленная версия приложения

STATUS*
string

Статус приложения. Возможные значения:

  • F (Free) — бесплатное
  • D (Demo) — демо-версия
  • T (Trial) — триальная версия, ограниченная по времени
  • P (Paid) — оплаченное приложение
  • S (Subscription) — приложение по подписке (Маркет+)

PAYMENT_EXPIRED*
string

[Y|N] Флаг, который показывает, истек ли оплаченный период или период триального использования

DAYS*
integer

Количество дней, оставшееся до конца оплаченного периода или периода триального использования

LANGUAGE_ID*
string

Установленный язык: ru, en и другие

Параметр auth

Название
тип

Описание

domain*
string

Адрес Битрикс24, на котором произошло событие

server_endpoint*
string

Адрес сервера авторизации для обновления токена

client_endpoint*
string

Общий путь для вызовов методов API Битрикс24

member_id*
string

Уникальный идентификатор Битрикс24

Продолжите изучение