Kontostand des Benutzers: Einen Gutschein einlösen

Xsolla Developers

oder

Zum Kundenportal

Kontostand des Benutzers: Einen Gutschein einlösenWebhook POST

Wird versendet, wenn ein Benutzer einen Gutschein einlöst, um virtuelle Gegenstände oder virtuelle Währung zu erhalten.

Request

Request Body schema: application/json

object

Angaben zum Gutschein (Objekt).

campaign_code	string Kampagne.
coupon_code	string Gutscheincode.

id_operation

integer

Operations-ID in der Xsolla-Datenbank.

items

Array of objects

Virtuelle Gegenstände des Kaufs.

items_operation_type

string

Operationstyp, der bei den virtuellen Gegenstände zum Einsatz kommt.

notification_type

string

Benachrichtigungstyp.

operation_type

string

Operationsart.

object

Benutzerdefinierte Projekteinstellungen (Objekt).

merchant_id	integer Händler-ID.
project_id	integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.

object

Benutzerdaten (Objekt).

id required	string Benutzer-ID.
email	string E-Mail des Benutzers.
name	string Benutzername.

object

Daten zum Kontostand des Benutzers (Objekt).

diff	string Menge der beim Kauf erworbenen virtuellen Währung.
new_value	string Kontostand nach der Transaktion.
old_value	string Kontostand vor der Transaktion.

Responses

204

Zur Signalisierung einer erfolgreiche Verarbeitung.

400

Im Falle eines Fehlers in den bereitgestellten Daten (z. B. fehlender erforderlicher Parameter, fehlgeschlagene Autorisierung usw.).

500

Im Falle von temporären Fehlern mit Ihren Servern.

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