Метод начисляет бонусы пользователю и создаёт операцию начисления в истории. Перед вызовом подключите модуль logictim.balls.

Пример

//Пример начисления 10-ти бонусов
$arFields = array(
                  "ADD_BONUS" => 10,
                  "USER_ID" => 1,
                  "OPERATION_TYPE" => 'USER_BALLANCE_CHANGE',
                  "OPERATION_NAME" => 'Начисление для теста',
                  "DEACTIVE_AFTER_TYPE" => 'M',
                  "DEACTIVE_AFTER" => 12,
                  "ORDER_ID" => '2',
                  "DETAIL_TEXT" => 'Описание',
                  "MAIL_EVENT" => array(
                                      "EVENT_NAME" => "LOGICTIM_BONUS_FROM_REPOST",
                                      "CUSTOM_FIELDS" => array(
                                                              "TEST_1" => 'Тестовое поле 1',
                                                              "TEST_2" => 'Тестовое поле 2',
                                                              )
                                        )
				);

logictimBonusApi::AddBonus($arFields);

Описание параметров

• ADD_BONUS - сколько бонусов начислить
• USER_ID - ID пользователя
• OPERATION_NAME - название операции для истории
• OPERATION_TYPE - тип операции (код значения свойства "Тип операции" из инфоблока "История операций бонусной системы"). Можно добавлять свои значения - при обновлении модуля они не затираются
• ORDER_ID - ID заказа (необязательный; указывается при начислении по конкретному заказу)
• DETAIL_TEXT - детальное описание операции
• MAIL_EVENT - массив для почтового события после начисления (если параметр есть - отправляется сообщение)
  • EVENT_NAME - код почтового события
  • CUSTOM_FIELDS - массив любых переменных для почтового шаблона

Дата сгорания бонусов

• DEACTIVE_AFTER - срок жизни (число дней или месяцев)
• DEACTIVE_AFTER_TYPE - тип срока: D - дней, M - месяцев. В примере выше - 12 месяцев

или

• DEACTIVE_DATE - дата сгорания в формате 01.01.2024. Имеет приоритет перед DEACTIVE_AFTER и DEACTIVE_AFTER_TYPE

Задержка начисления (активации)

Если указаны параметры ниже, создаётся операция ожидания начисления:

• ACTIVE_AFTER - число (через какое время активировать)
• ACTIVE_AFTER_TYPE - M (месяцы) или D (дни)

Пример: "ACTIVE_AFTER" => 14, "ACTIVE_AFTER_TYPE" => "D" - бонусы активируются через 14 дней.

Смотрите также: MinusBonus, UpdateBonus, UserBallance, события, оглавление API.