Solde utilisateur : achat

Xsolla Developers

Vers le Compte éditeur

Solde utilisateur : achatWebhook POST

Envoyé lorsque l'utilisateur achète quelque chose dans le jeu. Spécifie la modification du solde de l'utilisateur.

Request

Request Body schema: application/json

id_operation

integer

ID d'opération dans la base de données Xsolla.

Array of objects

Objets virtuels inclus dans l'achat.

Array

amount	integer Quantité de l'objet.
sku	string ID de l'objet.

items_operation_type

string

Type d'opération réalisée avec des objets virtuels.

notification_type

string

Type de notification.

operation_type

string

Type d'opération.

object

Paramètres personnalisés de projet (objet).

merchant_id	integer ID de commerçant.
project_id	integer ID de projet. Ce paramètre se trouve dans le Compte éditeur à côté du nom du projet.

object

Informations sur l'utilisateur (objet).

id required	string ID utilisateur.
email	string Adresse e-mail de l'utilisateur.
name	string Nom d'utilisateur.

object

Données sur solde utilisateur (objet).

diff	string Quantité de la monnaie virtuelle incluse dans l'achat.
new_value	string Solde après transaction.
old_value	string Solde avant transaction.

Responses

204

Renvoyez pour indiquer un traitement réussi.

400

Renvoyez en cas d'erreur dans les informations fournies (par exemple, un paramètre requis manquant, une autorisation échouée, etc.).

500

Renvoyez pour indiquer des erreurs temporaires liées à vos serveurs.

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"
}
}