# Reembolso

Cuando se cancela un pago, Xsolla envía los detalles de la transacción 
cancelada en un webhook con el tipo refund a la URL del webhook.

El mecanismo de reintento del webhook depende de quién haya iniciado el 
reembolso:
* Si el reembolso se inició desde su lado, el webhook no se volverá a enviar. El 
  pago se reembolsará al usuario independientemente de la respuesta al webhook.
* Si el reembolso lo inició un tercero (por ejemplo, un sistema de pagos o el 
  equipo de atención al cliente de Xsolla) y, en respuesta a un webhook, se 
  devolvió un código de estado 5xx, el webhook se reenvía a intervalos cada vez 
  mayores. El número máximo de reintentos es de 12 en un plazo de 48 horas desde 
  el primer intento.

Para obtener información detallada sobre el proceso de reembolso, consulte las 
instrucciones.


Aviso
El pago se reembolsará al usuario si se cumplen las siguientes condiciones:El reembolso lo inició Xsolla.En respuesta a un webhook, se devolvió un código de estado 4xx, o no se recibió ninguna respuesta tras todos los intentos, o se devolvió un código de estado 5xx.


Cuando guarde la URL del webhook en Cuenta del 
editor, también podrá configurar la recepción de información adicional en 
webhooks.


Nota
Si se registró en Cuenta del editor el 22 de enero de 2025 o antes, encontrará las opciones en su proyecto en 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
        Cancelación por solicitud del usuario/solicitud del juego
        Cancelación iniciada desde Cuenta del editor.
    
    
        2
        Chargeback (Contracargo)
        Contracargo de transacción solicitado.
    
    
        3
        Integration error (Error de integración)
        Problemas con la integración entre Xsolla y el juego.Recomendación: no añada el usuario a la lista de bloqueo.
    
    
        4
        Potential fraud (Fraude potencial)
        Sospecha de fraude.Recomendación: no añada el usuario a la lista de bloqueo.
    
    
        5
        Test payment (Pago de prueba)
        Transacción de prueba seguida de cancelación.Recomendación: no añada el usuario a la lista de bloqueo.
    
    
        6
        User invoice expired (Factura de usuario expirada)
        Factura vencida (se usa para el modelo de pospago).
    
    
        7
        Fraud notification from PS (Notificación de fraude de PS)
        Pago rechazado por el sistema de pago. Fraude potencial detectado por PS.Recomendación: añada el usuario a la lista de bloqueo.
    
    
        8
        Cancellation by the PS request (Cancelación solicitada por PS)
        Cancelación solicitada por el sistema de pago.Recomendación: no añada el usuario a la lista de bloqueo.
    
    
        9
        Cancellation by the user request (Cancelación solicitada por el usuario)
        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 game request
        Cancelación solicitada por el juego.Recomendación: no añada el usuario a la lista de bloqueo.
    
    
        11
        Account holder called to report fraud
        El titular de la cuenta declara que no realizó la transacción.
    
    
        12
        Friendly fraud
        Fraude amistoso comunicado.
    
    
        13
        Duplicate
        Transacción duplicada para la misma factura.

Endpoint: POST 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.country_wht` (object)
    Retención fiscal aplicada en determinados países debido a transacciones transfronterizas (objeto).

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

  - `payment_details.country_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.country_wht.percent` (number)
    Tipo de retención fiscal del país, %.

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

  - `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_method_fee` (object)
    Comisión del sistema de pago.

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

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

  - `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.sales_tax` (object)
    Impuesto sobre las ventas (objeto; solo en EE. UU. y Canadá).

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

  - `payment_details.user_acquisition_fee` (object)
    Importe total de los costes de adquisición del usuario deducidos por las compras realizadas mediante redes de afiliación e influencers (objeto).

  - `payment_details.user_acquisition_fee.percent` (number)
    Tasa del coste de adquisición del usuario, %.

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

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

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

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

  - `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.subscription` (object)
    Datos de la suscripción (objeto).

  - `purchase.subscription.amount` (number)
    Precio en moneda real.

  - `purchase.subscription.date_create` (string)
    Fecha de creación de la suscripción. Fecha y hora de conformidad con la norma [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601).

  - `purchase.subscription.plan_id` (string)
    ID del plan (externo si el plan se creó usando una API).

  - `purchase.subscription.subscription_id` (integer)
    ID de suscripción en la base de datos de Xsolla.

  - `purchase.subscription.tags` (array)
    Etiquetas del plan.

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

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

  - `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.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.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.

  - `transaction.payment_method_order_id` (string)
    ID de pago en el sistema de pago.

  - `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