Transaction rejetée par le système Anti-fraud

Xsolla Developers

Transaction rejetée par le système Anti-fraudWebhook POST

Lorsqu'une transaction est refusée pendant un contrôle du système Anti-fraud, Xsolla envoie les détails de la transaction via un webhook de type afs_reject à l'URL du webhook. Pour recevoir ce webhook, contactez votre responsable de la réussite client ou envoyez un e-mail à csm@xsolla.com.

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 la bascule correspondante 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

Afficher infos sur transactions effectuées via modes de paiement enregistrés

Bascule	Description
Afficher infos sur transactions effectuées via modes de paiement enregistrés	Les informations sont passées dans les paramètres personnalisés suivants du webhook : `saved_payment_method`: `0` — le mode de paiement enregistré n'a pas été utilisé ; `1` — le mode de paiement a été enregistré lors du paiement en cours ; `2` — le mode de paiement précédemment enregistré est utilisé. `payment_type`: `1` — paiement unique ; `2` — paiement récurrent.

Les informations sont passées dans les paramètres personnalisés suivants du webhook :

saved_payment_method:
- 0 — le mode de paiement enregistré n'a pas été utilisé ;
- 1 — le mode de paiement a été enregistré lors du paiement en cours ;
- 2 — le mode de paiement précédemment enregistré est utilisé.
payment_type:
- 1 — paiement unique ;
- 2 — paiement récurrent.

Request

Request Body schema: application/json

notification_type

required

string

Type de notification.

required

object

Détails de la transaction (objet).

agreement	integer ID de contrat.
dry_run	integer Transaction test. Le paramètre a la valeur 1 s'il s'agit d'une transaction test ou n'est pas envoyé si la transaction est réelle.
external_id	string External ID de la transaction.
id	integer ID de transaction.

object

Détails du remboursement (objet).

author	string Initiateur du remboursement.
code	integer ID de code.
reason	string Motif de remboursement.

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.
zip	string ZIP ou code postal 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 \
-d '{
  "notification_type": "afs_reject",
  "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"
  },
  "transaction": {
    "id": 1,
    "external_id": 1,
    "dry_run": 1,
    "agreement": 1
  },
  "refund_details": {
    "code": 4,
    "reason": "Potential fraud"
  }
}'

Response samples

application/json

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