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.

When you save the webhook URL in Publisher Account, you can give permissions to receive detailed information in webhooks. To do that, set the following toggle to active in Publisher Account in the Project settings > Webhooks > Advanced settings section.

Note

If you registered in Publisher Account on or before January 22, 2025, you can find the toggles in the Project settings > Webhooks > Testing > Payments > Advanced settings section.

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