Saldo del usuario: "Compra"

Xsolla Developers

A Cuenta del editor

Saldo del usuario: "Compra"Webhook POST

Se envía cuando un usuario compra algo dentro del juego. Indica el cambio en el saldo del usuario.

Request

Request Body schema: application/json

id_operation

integer

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

Array of objects

Artículos virtuales dentro de la compra.

Array

amount	integer Cantidad del artículo.
sku	string ID del artículo.

items_operation_type

string

Tipo de operación realizada con artículos virtuales.

notification_type

string

Tipo de notificación.

operation_type

string

Tipo de operación.

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.
email	string Correo electrónico del usuario.
name	string Nombre de usuario.

object

Datos del saldo del usuario (objeto).

diff	string Cantidad de moneda virtual en la compra.
new_value	string Saldo después de la transacción.
old_value	string Saldo antes de la transacción.

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
PHP
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'accept: application/json' \
-H 'content-type: application/json' \
-H 'authorization: Signature 13342703ccaca5064ad33ba451d800c5e823db8f' \
-d '{
        "settings": {
            "project_id": 18404,
            "merchant_id": 2340
        },
        "virtual_currency_balance": {
            "old_value": "0",
            "new_value": "200",
            "diff": "200"
        },
        "user": {
            "name": "Xsolla User",
            "id": "1234567",
            "email": "email@example.com"
        },
        "operation_type": "inGamePurchase",
        "notification_type": "user_balance_operation",
        "items_operation_type": "add",
            "items": [{
            "sku": "com.xsolla.item_1468",
            "amount": "2"
            }],
        "id_operation": "66989"
    }'

Response samples

application/json

{"error": {"code": "INCORRECT_AMOUNT",
"message": "Incorrect amount"
}
}