Anti-fraud-System lehnt Transaktion ab

Xsolla Developers

oder

Anti-fraud-System lehnt Transaktion abWebhook POST

Wird eine Transaktion während einer Prüfung vom Anti-fraud-System abgelehnt, sendet Xsolla die Transaktionsdetails in einem Webhook vom Typ afs_reject an die Webhook-URL. Wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, wenn Sie diesen Webhook erhalten möchten.

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.

Schalter Beschreibung

Infos über Transaktionen anzeigen, die mit gespeicherten Zahlungsmethoden getätigt wurden

Schalter	Beschreibung
Infos über Transaktionen anzeigen, die mit gespeicherten Zahlungsmethoden getätigt wurden	Informationen werden in den folgenden benutzerdefinierten Parametern des Webhooks übermittelt. `saved_payment_method`: `0` – die gespeicherte Zahlungsmethode wurde nicht verwendet `1` – die Zahlungsmethode wurde während des aktuellen Bezahlvorgangs gespeichert `2` – die zuvor gespeicherte Zahlungsmethode wird verwendet `payment_type`: `1` – Einmalzahlung `2` – wiederkehrende Zahlung

Informationen werden in den folgenden benutzerdefinierten Parametern des Webhooks übermittelt.

saved_payment_method:
- 0 – die gespeicherte Zahlungsmethode wurde nicht verwendet
- 1 – die Zahlungsmethode wurde während des aktuellen Bezahlvorgangs gespeichert
- 2 – die zuvor gespeicherte Zahlungsmethode wird verwendet
payment_type:
- 1 – Einmalzahlung
- 2 – wiederkehrende Zahlung

Request

Request Body schema: application/json

notification_type

required

string

Benachrichtigungstyp.

required

object

Details zur Transaktion (Objekt).

agreement	integer ID der Vereinbarung.
dry_run	integer Testtransaktion. Der Parameter hat den Wert 1, wenn es sich um eine Testtransaktion handelt. Er wird nicht gesendet, wenn es sich um eine echte Transaktion handelt.
external_id	string Externe ID der Transaktion.
id	integer ID der Transaktion.

object

Benutzerdaten (Objekt).

author	string Initiator der Rückerstattung.
code	integer Code-ID.
reason	string Grund für die Rückerstattung.

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.
zip	string Postleitzahl 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 \
-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"
}
}

Anti-fraud-System lehnt Transaktion abWebhook POST

Request Body schema: application/json

We respect your privacy