# Начисление баллов лояльности пользователю

Начисляет указанное количество баллов лояльности на баланс пользователя.

Endpoint: POST /projects/{project_id}/users/{user_id}/points/{point_id}/balance/credit
Version: 2.0.0
Security: basicAuth

## Path parameters:

  - `project_id` (integer, required)
    ID проекта. Вы можете найти этот параметр в Личном кабинете рядом с названием проекта, а также в адресной строке браузера при работе с проектом. URL-адрес имеет следующий формат: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `user_id` (string, required)
    ID пользователя на вашей стороне. Должен совпадать с ID, который вы передаете в параметре user.id при создании токена оплаты, так как баллы лояльности привязываются к этому ID.
    Example: "d342dad2-9d59-11e9-a384-42010aa8003f"

  - `point_id` (string, required)
    ID баллов лояльности. Баллы лояльности настраиваются в Личном кабинете в разделе LiveOps-инструменты > Программа лояльности. Чтобы получить ID, вызовите метод получения каталога — ID возвращается в параметре loyalty_rewards[].sku.
    Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"

## Request fields (application/json):

  - `amount` (number, required)
    Количество начисляемых баллов лояльности. Значение должно быть больше 0.
    Example: 50

  - `reason` (string, required)
    Причина изменения баланса в свободной форме (например: вознаграждение, компенсация, ручная корректировка).
    Example: "Manual adjustment"

## Response 200 fields (application/json):

  - `transaction_id` (string, required)
    ID транзакции начисления, созданной в результате запроса.
    Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"

  - `previous_balance` (number, required)
    Баланс баллов лояльности до начисления.
    Example: 100.5

  - `new_balance` (number, required)
    Баланс баллов лояльности после начисления.
    Example: 150.5

  - `amount` (number, required)
    Количество начисленных баллов лояльности.
    Example: 50

## Response 400 fields (application/json):

  - `message_id` (string, required)
    Код ошибки.
    Example: "error_bad_request"

  - `message` (string, required)
    Краткое описание ошибки.
    Example: "Invalid request body."

## Response 401 fields (application/json):

  - `statusCode` (integer)
    HTTP-статус ответа.

  - `errorCode` (integer)
    Код ошибки.

  - `errorMessage` (string)
    Краткое описание ошибки.

  - `transactionId` (string)
    ID запроса. Позволяет отслеживать и связывать записи логов для этого запроса или операции. Может использоваться для диагностики, отладки и аудита.

## Response 404 fields (application/json):

  - `message_id` (string, required)
    Код ошибки.
    Example: "error_not_found"

  - `message` (string, required)
    Краткое описание ошибки.
    Example: "User account or loyalty points not found."