Benutzervalidierung

Xsolla Developers

oder

BenutzervalidierungWebhook POST

Xsolla sendet einen Webhook vom Typ user_validation an die Webhook-URL, um zu überprüfen, ob ein Benutzer im Spiel registriert ist. Die Anfrage wird im Rahmen des Bezahlvorgangs mehrfach gesendet:

wenn ein Benutzer eine Zahlungsmethode im Zahlungsportal auswählt
wenn ein Benutzer Daten in die Zahlungsmaske eingibt, z. B. Bankkartendaten oder die Postleitzahl bei Zahlung über PayPal
wenn ein Benutzer auf Jetzt bezahlen klickt, um mit der Zahlung fortzufahren
wenn der Bezahlvorgang abgeschlossen ist und der Transaktionsstatus sich in done ändert

Die Anfrage wird beim Bezahlen gesendet, ganz gleich, welche Zahlungsmethode zum Einsatz kommt.

Wenn Sie die Webhook-URL im Kundenportal speichern, können Sie Berechtigungen erteilen, detaillierte Informationen in Webhooks zu empfangen. Aktivieren Sie dazu im Kundenportal unter Projekteins tellungen > Webhooks > Erweiterte Einstellungen die entsprechenden Schalter.

Hinweis

Wenn Sie sich am oder vor dem 22. Januar 2025 im Kundenportal registriert haben, finden Sie die Schalter unter Projekteinstellungen > Webhooks > Testen > Payments > Erweiterte Einstellungen.

Schalter	Beschreibung
Nur notwendige Nutzerparameter ohne vertrauliche Daten senden	Im Webhook werden nur die folgenden Nutzerinformationen übermittelt: ID Land
Individuelle Parameter senden	Informationen über individuelle Tokenparameter werden in dem Webhook übermittelt.

Schalter

Beschreibung

Nur notwendige Nutzerparameter ohne vertrauliche Daten senden

Im Webhook werden nur die folgenden Nutzerinformationen übermittelt:

ID
Land

Individuelle Parameter senden

Informationen über individuelle Tokenparameter werden in dem Webhook übermittelt.

Request

Request Body schema: application/json

notification_type

required

string

Benachrichtigungstyp.

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.
country	string Land des Benutzers. Ländercode, bestehend aus 2 Großbuchstaben gemäß ISO 3166-1 ALPHA-2.
email	string E-Mail des Benutzers.
ip	string Benutzer-IP.
name	string Benutzername.
phone	string Telefonnummer des Benutzers.

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 '{
    "notification_type":"user_validation",
    "settings": {
      "project_id": 18404,
      "merchant_id": 2340
    },
    "user": {
        "ip": "127.0.0.1",
        "phone": "18777976552",
        "email": "email@example.com",
        "id": "1234567",
        "name": "John Smith",
        "country": "US"
    }
}'

Response samples

application/json

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