Xsolla-logoXsolla Developers
oder
Zum Kundenportal

Abgelehnte ZahlungWebhook POST

Wenn eine Transaktion von einem Zahlungssystem abgelehnt wird, sendet Xsolla die Transaktionsdetails in einem Webhook vom Typ ps_declined an die von Ihnen festgelegte Webhook-URL. Der Webhook wird während der Autorisierung- oder Zahlungsabwicklung gesendet. In diesem Fall wird der Webhook payment\ order_paid nicht gesendet.

Typische Gründe für von Zahlungssystemen abgelehnte Zahlungen:

  • Die Kartenautorisierung ist fehlgeschlagen (z. B. konnte das Zahlungssystem den Autorisierungsvorgang aufgrund eines technischen Fehlers oder einer ausbleibenden Antwort der Bank nicht abschließen) oder wurde abgelehnt (z. B. hat die Bank geantwortet, die Transaktion jedoch aufgrund unzureichender Deckung oder ungültiger Kartendaten abgelehnt).
  • Die "3-D Secure"-Prüfung ist fehlgeschlagen, wurde nicht abgeschlossen oder es kam zu einem Timeout, weil der Nutzer nicht rechtzeitig bestätigt hat.
  • Der Zahlungsabwickler oder die abrechnende Bank (Acquirer) ist vorübergehend nicht verfügbar oder antwortet aufgrund eines nicht behebbaren Fehlers (z. B. einem geschlossenen Konto oder einer ungültigen Kartennummer) mit einer endgültigen Ablehnung. Ein erneuter Versuch ohne Behebung des zugrunde liegenden Problems führt nicht zu einer erfolgreichen Transaktion.

Nicht zu verwechseln mit:

  • Ablehnung durch Betrugsbekämpfungssysteme; diese werden über den Webhook afs_reject gemeldet.
  • Erstattungen oder Teilerstattungen nach einer erfolgreichen Zahlung; diese werden über die Webhooks refund und partial_refund gemeldet.

Hinweis

 Wenden Sie sich an Ihren Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, wenn Sie den Webhook ps_declined erhalten möchten.

Request
Request Body schema: application/json
notification_type
required
string

Benachrichtigungstyp.

required
object

Details zur Transaktion (Objekt).

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.

payment_method
integer

ID der Zahlungsart.

object

Benutzerdaten (Objekt).

author
string

Erstattungsinitiator. Der Feldwert wird gemäß der Tabelle übermittelt:

Erstattungsinitiator Feldwert
Spiel (über API). API
Kundenportal-Nutzer (automatische Erstattung). E-Mail-Adresse des Nutzers
Kundenportal-Nutzer (mit Unterstützung des Xsolla-Kundensupports). support@xsolla.com
Xsolla (mit Unterstützung des Xsolla-Kundensupports). support@xsolla.com
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.

Responses
204

Zur Signalisierung einer erfolgreiche Verarbeitung.

400

Rückgabe im Falle eines Fehlers in den bereitgestellten Informationen (z. B. fehlender erforderlicher Parameter, fehlgeschlagene Autorisierung usw.). In diesem Fall wird zwar das Geld des Nutzers abgebucht, der Kauf schlägt jedoch fehl. Um eine Rückerstattung vorzunehmen, wenden Sie sich an den Xsolla-Kundendienst unter support@xsolla.com.

500

Im Falle von temporären Fehlern mit Ihren Servern.

Request samples
curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Accept: application/json' \
-H 'Content-Type: application/json' \
-H 'Authorization: Signature 80543ba63e1e50cf05f15150fe75e7245da9a898' \
-d '{
  "notification_type": "ps_declined",
  "settings": {
    "project_id": "18404",
    "merchant_id": "2340"
  },
  "user": {
    "ip": "127.0.0.1",
    "email": "email@example.com",
    "id": "1234567",
    "country": "US"
  },
  "transaction": {
    "id": "1",
    "dry_run": "1",
    "payment_method": "1"
  },
  "refund_details": {
    "author": "support@xsolla.com",
    "code": "8",
    "reason": "Cancellation by the PS request",
    "reason_detail": "Insufficient funds"
  }
}'
Response samples
application/json
{
  • "error": {
    }
}