Validation utilisateur

Xsolla Developers

Validation utilisateurWebhook POST

Xsolla envoie un webhook de type user_validation à l'URL du webhook pour vérifier que l'utilisateur est enregistré dans le jeu. La requête est envoyée plusieurs fois pendant le processus de paiement :

lorsque l'utilisateur choisit un mode de paiement dans l'interface de paiement ;
lorsque l'utilisateur saisit des données dans le formulaire de paiement, par exemple les données de sa carte bancaire ou le code postal lors d'un paiement via PayPal ;
lorsque l'utilisateur clique sur Pay now pour procéder au paiement ;
lorsque le processus de paiement est terminé et que le statut de la transaction passe à done.

La requête est envoyée lors d'un paiement via n'importe quel mode de paiement.

Lorsque vous enregistrez l'URL du webhook dans le Compte éditeur, vous pouvez activer les autorisations pour recevoir des informations détaillées dans les webhooks. Pour ce faire, activez les bascules correspondantes dans la section Project settings > Webhooks > Advanced settings.

Note

Si vous avez créé un Compte éditeur le 22 janvier 2025 ou avant, les bascules se trouvent dans la section Project settings > Webhooks > Testing > Payments > Advanced settings.

Bascule	Description
Envoyer paramètres utilisateur nécessaires seulement sans données sensibles	Seules les informations suivantes sur l'utilisateur sont passées dans le webhook : ID ; pays.
Envoyer paramètres personnalisés	Les informations relatives aux paramètres du jeton personnalisé sont passées dans le webhook.

Bascule

Description

Envoyer paramètres utilisateur nécessaires seulement sans données sensibles

Seules les informations suivantes sur l'utilisateur sont passées dans le webhook :

ID ;
pays.

Envoyer paramètres personnalisés

Les informations relatives aux paramètres du jeton personnalisé sont passées dans le webhook.

Request

Request Body schema: application/json

notification_type

required

string

Type de notification.

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.
country	string Pays de l'utilisateur. Code pays à deux lettres majuscules selon la norme ISO 3166-1 alpha-2.
email	string Adresse e-mail de l'utilisateur.
ip	string IP de l'utilisateur.
name	string Nom d'utilisateur.
phone	string Téléphone de l'utilisateur.

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