Xsolla-logo

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.

Sie können die Berechtigung erteilen, detaillierte Informationen in Webhooks zu erhalten. Dazu müssen Sie im Kundenportal unter Projekteinstellungen > Webhooks > Erweiterte Einstellungen die folgenden Schalter auf Ein stellen.

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