Xsolla-logoXsolla Developers
o
A Cuenta del editor

PagoWebhook POST

Se envía cada vez que un usuario realiza un pago. Incluye los datos del pago.

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_date
string

Fecha del pago.

payment_method
integer

ID del método de pago.

payment_method_name
string

Nombre del método de pago.

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

Detalles del cupón (objeto; si se utilizó un cupón al crear la suscripción).

campaign_code
string

Código de campaña.

coupon_code
string

Código de cupón.

object

Datos del regalo (objeto).

giver_id
string

ID del obsequiador.

hide_giver_from_receiver
string

Si se oculta la identidad del obsequiador al destinatario.

message
string

Mensaje del obsequiador.

receiver_email
string

Correo electrónico del destinatario del regalo.

receiver_id
string

ID del destinatario del regalo.

object

Objeto que contiene información sobre un pedido. Esta información no se transmite en el webhook por defecto. Para habilitar esta función, contacte con su gestor de cuentas o envíe un correo electrónico a am@xsolla.com.

id
integer

ID de pedido.

object

Objeto que contiene información sobre un artículo.

object

Objeto que contiene información sobre el precio de un artículo.

amount
number <float>

Precio total del artículo en la moneda seleccionada.

currency
string

Moneda del precio del artículo.

quantity
integer

Cantidad del artículo.

sku
string

Código (SKU) del artículo.

object
Deprecated

Claves del juego (matriz).

amount
number <float>
Deprecated

Precio.

currency
string
Deprecated

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

digital_content
string
Deprecated

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

drm
string
Deprecated

Plataforma DRM empleada para distribuir el juego. Asegúrese de haber configurado las plataformas DRM necesarias en su Cuenta del editor.

Enum: "steam" "playstation" "xbox" "uplay" "origin" "drmfree" "gog" "epicgames" "nintendo_eshop" "discord_game_store" "oculus"
object
Deprecated

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.

Array of objects

Promociones aplicadas a esta transacción.

Array
id
integer

ID de promoción.

technical_name
string

Nombre técnico de la promoción.

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.

date_next_charge
string

Próxima fecha de facturació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).

product_id
string

ID del producto (si se envía en el token de acceso).

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.

sku
string
Deprecated

Código de artículo (SKU) del paquete de moneda virtual (si se estableció para el paquete de moneda virtual).

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

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.). En este caso, se carga el importe en la cuenta del usuario, pero hay un fallo en la compra. Para hacer un reembolso, contacte con el servicio de atención al cliente de Xsolla escribiendo a support@xsolla.com.

500

Devuelve para indicar errores temporales en sus servidores.

Request samples 
curl -v 'https://your.hostname/your/uri' \
-X POST \
-d '{
    "notification_type": "payment",
    "settings": {
      "project_id": 18404,
      "merchant_id": 2340
    },
    "purchase": {
        "virtual_currency": {
            "name": "Coins",
            "sku": "com.xsolla.package1",
            "quantity": 10,
            "currency": "USD",
            "amount": 100
        },
        "subscription": {
            "plan_id": "b5dac9c8",
            "subscription_id": "10",
            "product_id": "Demo Product",
            "date_create": "2014-09-22T19:25:25+04:00",
            "date_next_charge": "2014-10-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
        },
        "promotions": [{
            "technical_name": "Demo Promotion",
            "id": "853"
        }],
        "coupon": {
            "coupon_code": "ICvj45S4FUOyy",
            "campaign_code": "1507"
        },
        "order": {
          "id": 1234
          "lineitems": [
          {
            "sku": "com.xsolla.item_1",
            "quantity": 1,
            "price": {
              "currency": "EUR",
              "amount": 6.5
              }
          }
          ]
          }
    },
    "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,
        "payment_date": "2014-09-24T20:38:16+04:00",
        "payment_method": 1,
        "payment_method_name": "PayPal",
        "payment_method_order_id": 1234567890123456789,
        "dry_run": 1,
        "agreement": 1
    },
    "payment_details": {
        "payment": {
            "currency": "USD",
            "amount": 230
        },
        "vat": {
            "currency": "USD",
            "amount": 0,
            "percent": 20
        },
        "sales_tax": {
            "currency": "USD",
            "amount": 0,
            "percent": 0
        },
        "direct_wht": {
            "currency": "USD",
            "amount": 0,
            "percent": 0
        },
        "payout_currency_rate": 1,
        "payout": {
            "currency": "USD",
            "amount": 200
        },
        "xsolla_fee": {
            "currency": "USD",
            "amount": 10
        },
        "payment_method_fee": {
            "currency": "USD",
            "amount": 20
        },
        "repatriation_commission": {
            "currency": "USD",
            "amount": 10
        }
    },
    "custom_parameters": {
        "parameter1": "value1",
        "parameter2": "value2"
    }
}'
Response samples
application/json
{
  • "error": {
    }
}
System statusAll services operational

Privacy Settings

Privacy PolicyEnd User License Agreement© 2006–2025 Xsolla Inc.