Xsolla-logo

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.

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

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