Solde utilisateur : échange de coupon

Xsolla Developers

Vers le Compte éditeur

Solde utilisateur : échange de couponWebhook POST

Envoyé lorsque l'utilisateur échange un coupon pour recevoir des objets virtuels ou de la monnaie virtuelle.

Request

Request Body schema: application/json

object

Informations sur le coupon (objet).

campaign_code	string Code de campagne.
coupon_code	string Code de coupon.

id_operation

integer

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

items

Array of objects

Objets virtuels inclus dans l'achat.

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": "0",
            "diff": "0"
        },
        "user": {
            "name": "Xsolla User",
            "id": "1234567",
            "email": "email@example.com"
        },
        "operation_type": "coupon",
        "notification_type": "user_balance_operation",
        "items_operation_type": "add",
            "items": [{
                "sku": "com.xsolla.item_1468",
                "amount": "2"
            }],
        "id_operation": "66989",
        "coupon": {
            "coupon_code": "test123",
            "campaign_code": "Xsolla Campaign"
        }
    }'

Response samples

application/json

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