# Deducir del saldo de puntos de fidelidad del usuario

Deduce el importe especificado del saldo de puntos de fidelidad del usuario.

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

## Path parameters:

  - `project_id` (integer, required)
    ID del proyecto. Encontrará este parámetro en su Cuenta del editor junto al nombre del proyecto y en la barra de direcciones del navegador cuando se trabaja en un proyecto. La URL tiene el siguiente formato: https://publisher.xsolla.com//projects/.
    Example: 44056

  - `user_id` (string, required)
    ID de usuario en su sistema. Este ID debe coincidir con el valor que se transmite en el parámetro user.id al crear un token de pago, ya que los puntos de fidelidad están asociados a este ID de usuario.
    Example: "d342dad2-9d59-11e9-a384-42010aa8003f"

  - `point_id` (string, required)
    ID de punto de fidelidad. Los puntos de fidelidad se configuran en Cuenta del editor, en LiveOps > Loyalty program. Para obtener el ID, utilice la llamada API de obtención de catálogo; el ID se devuelve en el parámetro loyalty_rewards[].sku.
    Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"

## Request fields (application/json):

  - `amount` (number, required)
    Importe de puntos de fidelidad que se van a deducir. Debe ser un valor positivo.
    Example: 50

  - `reason` (string, required)
    Motivo del cambio de saldo en formato de texto libre (por ejemplo, recompensa, compensación, ajuste manual).
    Example: "Manual adjustment"

## Response 200 fields (application/json):

  - `transaction_id` (string, required)
    ID de la transacción de débito creada como resultado de esta solicitud.
    Example: "3fa85f64-5717-4562-b3fc-2c963f66afa6"

  - `previous_balance` (number, required)
    Saldo antes del débito.
    Example: 150.5

  - `new_balance` (number, required)
    Saldo después del débito.
    Example: 100.5

  - `amount` (number, required)
    Importe que se ha deducido del saldo.
    Example: 50

## Response 400 fields (application/json):

  - `message_id` (string, required)
    Código de error.
    Example: "error_bad_request"

  - `message` (string, required)
    Breve descripción del error.
    Example: "Invalid request body."

## Response 401 fields (application/json):

  - `statusCode` (integer)
    Estado de la respuesta HTTP

  - `errorCode` (integer)
    Código de error.

  - `errorMessage` (string)
    Breve descripción del error.

  - `transactionId` (string)
    ID de solicitud. El ID empleado para hacer un seguimiento y asociar las entradas de registro relacionadas con esta solicitud u operación específica. Este ID puede resultar útil para la resolución de problemas, la depuración y la auditoría.

## Response 404 fields (application/json):

  - `message_id` (string, required)
    Código de error.
    Example: "error_not_found"

  - `message` (string, required)
    Breve descripción del error.
    Example: "User account or loyalty points not found."

## Response 422 fields (application/json):

  - `message_id` (string, required)
    Código de error.
    Example: "error_bad_request"

  - `message` (string, required)
    Breve descripción del error.
    Example: "Insufficient loyalty point balance."