Xsolla-logo
o
A Cuenta del editor

ReembolsoWebhook POST

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 guardado
    • 1: el método de pago se guardó al realizar el pago actual
    • 2: se utiliza el método de pago guardado previamente
  • payment_type:
    • 1: pago único
    • 2: 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.
Request
Request Body schema: application/json
notification_type
required
string

Tipo de notificación.

required
object

Datos de la transacción (objeto).

agreement
integer

ID del acuerdo.

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.

external_id
string

ID externo de la transacción.

id
integer

ID de la transacción.

payment_method_order_id
string

ID de pago en el sistema de pago.

required
object

Datos del pago (objeto).

object

Retención fiscal directa.

amount
number <float>

Importe.

currency
string

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

percent
number <float>

Tipo de retención fiscal directa.

object

Importe pagado por el usuario (objeto).

amount
number <float>

Importe.

currency
string

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

object

Comisión del sistema de pago.

amount
number <float>

Importe.

currency
string

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

object

Importe cargado en el sistema de pago.

amount
number <float>

Importe.

currency
string

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

object

Datos del desembolso (objeto).

amount
number <float>

Importe.

currency
string

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

payout_currency_rate
string

Tipo de cambio entre las monedas de pago y de desembolso.

object

Objeto con datos sobre costes de repatriación, que son impuestos a Xsolla por terceros.

amount
number <float>

Importe.

currency
string

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

object

Impuesto sobre las ventas (objeto; solo en EE. UU. y Canadá).

amount
number <float>

Importe.

currency
string

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

percent
number <float>

Tipo impositivo sobre las ventas.

object

Datos sobre el IVA (objeto; solo en la UE).

amount
number <float>

Importe.

currency
string

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

percent
number <float>

Tipo de IVA.

object

Importe cargado en el saldo de Xsolla.

amount
number <float>

Importe.

currency
string

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

object

Comisión de Xsolla (objeto).

amount
number <float>

Importe.

currency
string

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

custom_parameters
object

Sus parámetros personalizados.

object

Datos de la compra (objeto).

required
object

Precio total de la compra (objeto).

amount
number <float>

Importe total del pago.

currency
string

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

object

Datos del proceso de pago (objeto).

amount
number <float>

Importe de la compra.

currency
string

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

object
Deprecated

Claves del juego (matriz).

object

Objeto con los datos de actualización.

amount
number <float>
Deprecated

Precio en moneda real.

currency
string
Deprecated

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

object
Deprecated

Objeto con datos sobre el paquete, desde el cual el usuario lo actualizó.

DRM
string
Deprecated

Plataforma de DRM (gestión de derechos digitales) del juego.

digital_content
string
Deprecated

Código de artículo (SKU) del juego establecido en la Cuenta del editor.

object
Deprecated

Objeto con datos sobre el paquete, al cual el usuario lo actualizó.

DRM
string
Deprecated

Plataforma de DRM (gestión de derechos digitales) del juego.

digital_content
string
Deprecated

Código de artículo (SKU) del juego establecido en la Cuenta del editor.

object

Datos de la suscripción (objeto).

amount
number <float>

Precio en moneda real.

currency
string

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

date_create
string

Fecha de creación de la suscripción. Fecha y hora de conformidad con la norma ISO 8601.

plan_id
string

ID del plan (externo si el plan se creó usando una API).

subscription_id
integer

ID de suscripción en la base de datos de Xsolla.

tags
Array of strings

Etiquetas del plan.

object
Deprecated

Moneda virtual para comprar (objeto).

amount
number <float>
Deprecated

Precio en moneda real.

currency
string
Deprecated

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

name
string
Deprecated

Nombre de la moneda virtual.

quantity
number <float>
Deprecated

Cantidad.

object
Deprecated

Artículos virtuales en la compra (objeto).

amount
number <float>
Deprecated

Importe de la compra.

currency
string
Deprecated

Moneda. Código de moneda de tres letras de conformidad con la norma ISO 4217.

Array of objects
Deprecated
Array
amount
number <float>
Deprecated

Cantidad del artículo.

sku
string
Deprecated

ID del artículo.

object

Detalles del reembolso (objeto).

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
code
integer

ID del código.

reason
string

Motivo del reembolso.

object

Configuración del proyecto personalizada (objeto).

merchant_id
integer

ID de vendedor.

project_id
integer

ID del proyecto. Encontrará este parámetro en su cuenta Publisher junto al nombre del proyecto.

object

Datos del usuario (objeto).

id
required
string

ID de usuario.

country
string

Código de país. Dos letras mayúsculas de conformidad con la norma ISO 3166-1 alpha-2.

email
string

Correo electrónico del usuario.

ip
string

IP del usuario.

name
string

Nombre de usuario.

phone
string

Teléfono del usuario.

zip
string

Código postal o ZIP del usuario.

Responses
204

Devuelve para indicar un procesamiento realizado correctamente.

400

Devuelve en caso de error en la información proporcionada (p. ej., falta un parámetro obligatorio, autorización fallida, etc.).

500

Devuelve para indicar errores temporales en sus servidores.

Request samples 
curl -v 'https://your.hostname/your/uri' \
-X POST \
-d '{
        "notification_type": "refund",
        "settings": {
          "project_id": 18404,
          "merchant_id": 2340
        },
        "purchase": {
            "virtual_currency": {
                "name": "Coins",
                "quantity": 10,
                "currency": "USD",
                "amount": 100
            },
            "subscription": {
                "plan_id": "b5dac9c8",
                "subscription_id": "10",
                "date_create": "2014-09-22T19:25:25+04:00",
                "currency": "USD",
                "amount": 9.99
            },
            "checkout": {
                "currency": "USD",
                "amount": 50
            },
            "virtual_items": {
                "items": [
                    {
                        "sku": "com.xsolla.item1",
                        "amount": 1
                    }
                ],
                "currency": "USD",
                "amount": 50
            },
            "total":{
                "currency": "USD",
                "amount": 200
            }
        },
        "user": {
            "ip": "127.0.0.1",
            "phone": "18777976552",
            "email": "email@example.com",
            "id": "1234567",
            "name": "Xsolla User",
            "country": "US"
        },
        "transaction": {
            "id": 1,
            "external_id": 1,
            "dry_run": 1,
            "agreement": 1
        },
        "refund_details": {
            "code": 4,
            "reason": "Potential fraud"
        },
        "payment_details": {
            "sales_tax": {
                "currency": "USD",
                "amount": 0
            },
            "direct_wht": {
                "currency": "USD",
                "amount": 0.70
            },
            "xsolla_fee": {
                "currency": "USD",
                "amount": "10"
            },
            "payout": {
                "currency": "USD",
                "amount": "200"
            },
            "payment_method_fee": {
                "currency": "USD",
                "amount": "20"
            },
            "payment": {
                "currency": "USD",
                "amount": "230"
            },
            "repatriation_commission": {
                "currency": "USD",
                "amount": 10
            }
        }
    }
}'
Response samples
application/json
{
  • "error": {
    }
}

Privacy Settings

Privacy PolicyEnd User License Agreement
System statusAll services operational
© 2006–2025 Xsolla Inc.