# Reembolso parcial

Cuando se realiza un reembolso parcial, Xsolla envía los detalles de la 
transacción cancelada en un webhook con el tipo de partial_refund a la URL 
del webhook. Obtenga más información sobre el proceso de reembolso parcial en 
estas instrucciones.

Al guardar la URL del webhook en Cuenta del editor, puede dar permisos para 
recibir información detallada en los webhooks. Para ello, active la siguiente 
opción en Cuenta del editor en Project 
settings > Webhooks > Advanced settings.


Nota
Si se registró en Cuenta del editor el 22 de enero de 2025 o antes, encontrará las opciones en Project settings > Webhooks > Testing > Payments > Advanced settings.




    
        Conmutador
        Descripción
    


    
        Mostrar información sobre las transacciones mediante los métodos de pago guardados
        La información se transmite en los siguientes parámetros personalizados del webhook:saved_payment_method:0: no se utilizó el método de pago guardado1: el método de pago se guardó al realizar el pago actual2: se utiliza el método de pago guardado previamentepayment_type:1: pago único2: pago periódico
    



Códigos de reembolso:


    
    
        Código
        Motivo
        Descripción
    
    
    
    
        1
        Cancellation by the user request / the game request
        Cancelación iniciada desde Cuenta del editor.
    
    
        3
        Integration error
        Problemas con la integración entre Xsolla y el juego.Recomendación: no añada el usuario a la lista de bloqueo.
    
    
        5
        Test payment
        Transacción de prueba seguida de cancelación.Recomendación: no añada el usuario a la lista de bloqueo.
    
    
        7
        Fraud notification from PS
        El pago fue rechazado porque el sistema de pago detectó un posible fraude.Recomendación: Agregue al usuario a la lista de bloqueo.
    
    
        9
        Cancellation by the user request
        El usuario no quedó satisfecho con el juego o con la compra por cualquier motivo.Recomendación: no añada el usuario a la lista de bloqueo.
    
    
        10
        Cancellation by the PS request
        Cancelación solicitada por el juego.Recomendación: no añada el usuario a la lista de bloqueo.

Endpoint: POST partial-refund
Version: 1.0

## Request fields (application/json):

  - `custom_parameters` (object)
    Sus parámetros personalizados.

  - `notification_type` (string, required)
    Tipo de notificación.

  - `payment_details` (object, required)
    Datos del pago (objeto).

  - `payment_details.direct_wht` (object)
    Retención fiscal directa.

  - `payment_details.direct_wht.amount` (number)
    Importe.

  - `payment_details.direct_wht.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.direct_wht.percent` (number)
    Tipo de retención fiscal directa.

  - `payment_details.payment` (object)
    Importe pagado por el usuario (objeto).

  - `payment_details.payment.amount` (number)
    Importe.

  - `payment_details.payment.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payment_method_fee` (object)
    Comisión del sistema de pago.

  - `payment_details.payment_method_fee.amount` (number)
    Importe.

  - `payment_details.payment_method_fee.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payment_method_sum` (object)
    Importe cargado en el sistema de pago.

  - `payment_details.payment_method_sum.amount` (number)
    Importe.

  - `payment_details.payment_method_sum.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payout` (object)
    Datos del desembolso (objeto).

  - `payment_details.payout.amount` (number)
    Importe.

  - `payment_details.payout.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.payout_currency_rate` (string)
    Tipo de cambio entre las monedas de pago y de desembolso.

  - `payment_details.repatriation_commission` (object)
    Objeto con datos sobre costes de repatriación, que son impuestos a Xsolla por terceros.

  - `payment_details.repatriation_commission.amount` (number)
    Importe.

  - `payment_details.repatriation_commission.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.sales_tax` (object)
    Impuesto sobre las ventas (objeto; solo en EE. UU. y Canadá).

  - `payment_details.sales_tax.amount` (number)
    Importe.

  - `payment_details.sales_tax.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.sales_tax.percent` (number)
    Tipo impositivo sobre las ventas.

  - `payment_details.vat` (object)
    Datos sobre el IVA (objeto; solo en la UE).

  - `payment_details.vat.amount` (number)
    Importe.

  - `payment_details.vat.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.vat.percent` (number)
    Tipo de IVA.

  - `payment_details.xsolla_balance_sum` (object)
    Importe cargado en el saldo de Xsolla.

  - `payment_details.xsolla_balance_sum.amount` (number)
    Importe.

  - `payment_details.xsolla_balance_sum.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `payment_details.xsolla_fee` (object)
    Comisión de Xsolla (objeto).

  - `payment_details.xsolla_fee.amount` (number)
    Importe.

  - `payment_details.xsolla_fee.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `purchase` (object)
    Datos de la compra (objeto).

  - `purchase.checkout` (object)
    Datos del proceso de pago (objeto).

  - `purchase.checkout.amount` (number)
    Importe de la compra.

  - `purchase.checkout.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `purchase.total` (object, required)
    Precio total de la compra (objeto).

  - `purchase.total.amount` (number)
    Importe del pago del reembolso parcial.

  - `purchase.total.currency` (string)
    Moneda. Código de moneda de tres letras de conformidad con la norma [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217).

  - `refund_details` (object)
    Detalles del reembolso (objeto).

  - `refund_details.author` (string)
    Iniciador del reembolso. El valor del campo se transmite de acuerdo con la 
tabla:


    
    
        Iniciador del reembolso
        Valor de campo
    
    
    
    
        Juego (vía API).
        API
    
    
        Usuario de Cuenta del editor (reembolso automático).
        Correo electrónico del usuario
    
    
        Usuario de Cuenta del editor (con asistencia del servicio de atención al cliente de Xsolla).
        support@xsolla.com
    
    
        Xsolla (con asistencia del servicio de atención al cliente de Xsolla).
        support@xsolla.com

  - `refund_details.code` (integer)
    ID del código.

  - `refund_details.date` (string)
    Fecha del reembolso.

  - `refund_details.reason` (string)
    Motivo del reembolso.

  - `settings` (object)
    Configuración del proyecto personalizada (objeto).

  - `settings.merchant_id` (integer)
    ID de vendedor.

  - `settings.project_id` (integer)
    ID del proyecto. Encontrará este parámetro en su cuenta [Publisher](https://publisher.xsolla.com/) junto al nombre del proyecto.

  - `transaction` (object, required)
    Datos de la transacción (objeto).

  - `transaction.agreement` (integer)
    ID del acuerdo.

  - `transaction.date` (string)
    Fecha de la transacción.

  - `transaction.dry_run` (integer)
    Transacción de prueba. El parámetro tiene el valor 1 si es una transacción de prueba, o no se envía si la transacción es real.

  - `transaction.external_id` (string)
    ID externo de la transacción.

  - `transaction.id` (integer)
    ID de la transacción.

  - `user` (object)
    Datos del usuario (objeto).

  - `user.country` (string)
    Código de país. Dos letras mayúsculas de conformidad con la norma [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

  - `user.email` (string)
    Correo electrónico del usuario.

  - `user.id` (string, required)
    ID de usuario.

  - `user.ip` (string)
    IP del usuario.

  - `user.name` (string)
    Nombre de usuario.

  - `user.phone` (string)
    Teléfono del usuario.

  - `user.zip` (string)
    Código postal o ZIP del usuario.

## Response 400 fields (application/json):

  - `error` (object)

  - `error.code` (string)

  - `error.message` (string)


## Response 204 fields

## Response 500 fields