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


Al guardar la URL del webhook en la cuenta, también puede configurar la recepción de información adicional en 
los webhooks.


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




    
        Opción
        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
    
    
        Mostrar información sobre el motivo del reembolso.
        Información detallada sobre los motivos del reembolso.
    



Códigos de reembolso:


    
    
        Código
        Motivo
        Descripción
    
    
    
    
        1
        Cancellation by the user request / the game request
        Cancelación iniciada desde la cuenta.
    
    
        2
        Chargeback
        Contracargo de transacción solicitado.
    
    
        3
        Integration error
        Problemas con la integración entre Xsolla y el juego.Recomendación: no agregue el usuario a la lista de bloqueo.
    
    
        4
        Potential fraud – AFS reject
        La transacción ha sido rechazada porque el sistema antifraude de Xsolla ha detectado un posible fraude.
    
    
        5
        Test payment
        Transacción de prueba seguida de cancelación.Recomendación: no agregue el usuario a la lista de bloqueo.
    
    
        6
        User invoice expired
        Factura vencida (se usa para el modelo de pospago).
    
    
        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.
    
    
        8
        Cancellation by the PS request
        Cancelación solicitada por el sistema de pago.Recomendación: no agregue el 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 agregue el usuario a la lista de bloqueo.
    
    
        10
        Cancellation by the PS request
        Cancelación solicitada por el juego.Recomendación: no agregue el usuario a la lista de bloqueo.
    
    
        11
        Account holder called to report fraud
        El titular de la cuenta afirma que no hizo la transacción.Recomendación: Agregue al usuario a la lista de bloqueo.
    
    
        12
        Potential fraud – friendly fraud
        El titular legítimo de la tarjeta ha impugnado la transacción.
    
    
        13
        Duplicate
        Transacción duplicada para la misma factura.
    
    
        21
        Potential fraud – BIN attack
        Tarjetas robadas de uno o varios números de identificación bancaria (NIB) en un mismo lote. Un indicador clave es una oleada de intentos que comparten un rango de números de NIB en un intervalo de tiempo breve, a menudo con números de tarjeta enumerados.
    
    
        22
        Potential fraud – friendly fraud
        Tarjeta robada empleada para comprar artículos comercializables con el fin de revenderlos.
    
    
        23
        Potential fraud – low-scale card fraud
        Tarjetas robadas de uno o varios números NIB. No es tan generalizado ni tan coordinado como el ataque de NIB (código de reembolso 21).
    
    
        24
        Potential fraud – regional price abuse
        Uso indebido de los precios regionales o de la reventa. Los usuarios se aprovechaban de los precios regionales —normalmente falseando su ubicación o el método de pago— para adquirir artículos a bajo precio y revenderlos en mercados con precios más elevados.
    
    
        25
        Potential fraud – partner or PS exploit
        Robo de credenciales y apropiación de cuentas: uso indebido de una cuenta o integración en el lado de un socio o del sistema de pago, en lugar del uso indebido directo de una tarjeta.
    
    
        26
        Potential fraud – not definable
        Se ha confirmado el fraude, pero no hay pruebas suficientes para determinar el tipo exacto de ataque.
    
    
        27
        Fraud notification from PS – linked transactions
        La propia transacción no se especificaba en el informe de fraude del sistema de pago, pero está relacionada, p. ej., a través de una tarjeta o un dispositivo compartido, con transacciones que fueron reembolsadas por motivos de fraude.

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)
    Objeto con datos sobre los costes de retención fiscal en origen aplicados en determinados países por transacciones transfronterizas.

  - `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)
    Porcentaje de la tasa de costes de retención fiscal en origen.

  - `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.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.amount` (number)
    Importe.

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

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

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

  - `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 la cuenta (reembolso automático).
        Correo electrónico del usuario
    
    
        Usuario de la cuenta (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](/es/webhooks/overview/#business-accounts), 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