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

Пример

//Пример списания 10-ти бонусов
$arFields = array(
                  "MINUS_BONUS" => 10,
                  "USER_ID" => 1,
                  "OPERATION_TYPE" => 'USER_BALLANCE_CHANGE',
                  "OPERATION_NAME" => 'Списание для теста',
                  "ORDER_ID" => '',
                  "DETAIL_TEXT" => 'Описание',
                  "MAIL_EVENT" => array(
                                      "EVENT_NAME" => "КОД ПОЧТОВОГО СОБЫТИЯ БИТРИКС",
                                      "CUSTOM_FIELDS" => array(
                                                              "TEST_1" => 'Тестовое поле 1',
                                                              "TEST_2" => 'Тестовое поле 2',
                                                              )
                                        )
				);

logictimBonusApi::MinusBonus($arFields);

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

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

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