Streitfall

StreitfallWebhook POST

Wenn ein neuer Streitfall eröffnet wird oder sich der Status eines Streitfalls ändert, sendet Xsolla einen Webhook vom Typ dispute 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.

Request

Request Body schema: application/json

notification_type

required

string

Benachrichtigungstyp.

action

required

string

Aktionstyp.

Enum:	Description
adding	Ein neuer Streitfall wurde eröffnet.
updating	Der Status eines Streitfalls hat sich geändert.

required

object

Objekt mit Informationen über die Transaktion.

required

integer

ID der Transaktion.

date_create

required

string

Zahlungsdatum.

required

object

Objekt mit Informationen über den Transaktionsbetrag.

amount required	number <float> Zahlungsbetrag.
currency required	string Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

payment_method

required

string

Zahlungsmethode.

Enum:	Description
credit_debit_card	Kredit- oder Debitkarte
paypal	PayPal

country_code

required

string

Land des Benutzers. Ländercode, bestehend aus 2 Großbuchstaben gemäß ISO 3166-1 ALPHA-2.

external_id

string

Externe Transaktions-ID. Ausführliche Informationen finden Sie in den FAQs.

required

object

Objekt mit Informationen über die benutzerdefinierten Projekteinstellungen.

project_id required	integer Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.
merchant_id required	integer Händler-ID.

required

object

Objekt mit Informationen über einen Benutzer.

id required	string Benutzer-ID.
email	string E-Mail des Benutzers.

required

object

Objekt mit Informationen über den Streitfall.

incoming_date

required

string

Datum der Streitfalleröffnung gemäß dem Standard RFC 3339.

reason

required

string

Grund für die Eröffnung des Streitfalls. Eine Beschreibung von Gründen finden Sie in der Dokumentation.

Enum: "non_receipt" "not_as_described" "duplicate_processing" "paid_by_other_means" "incorrect_amount" "credit_not_processed" "general" "fraud" "cancelled_recurring" "cancelled_merchandise" "late_presentment" "no_authorization" "problem_with_remittance" "other"

type

required

string

Art des Streitfalls.

Enum:	Description
1st_time_chargeback	Erste Rückbuchung.
2nd_time_chargeback	Zweite Rückbuchung (vor dem Schiedsverfahren).
arbitration	Beilegung eines Streitfalls zwischen der ausstellenden Bank und dem Händler, wenn die erste Rückbuchung und die zweite Rückbuchung abgelehnt wurden.
chargeback	Erste Rückbuchung.
chargeback_reversal	Die Rückbuchung wurde widerrufen.
claim	Ein Streit zwischen einem Kunden und einem Händler in PayPal.
dispute	Ein Karteninhaber hat bei der Bank Zahlungsdaten angefordert.
inquiry	Ein Karteninhaber hat bei der Bank Zahlungsdaten angefordert.
other	Wird für Rückbuchungen verwendet, die von keinem anderen Typ abgedeckt sind.
reimbursement	Die Erstattung ist erfolgt.
reimbursement_reversal	Die Rückbuchung wurde widerrufen.
representment	Das für Rückbuchungen zuständige Team hat die Nachweise an das Zahlungssystem geschickt.
representment_reversal	Die Rückbuchung wurde widerrufen.
retrieval	Ein Karteninhaber hat bei der Bank Zahlungsdaten angefordert.

status

required

string

Status des Streitfalls.

Enum:	Description
accepted	Akzeptiert
lost	Verloren
new	Neu
no_actions_required	Laufend
won	Gewonnen

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
HTTP

curl -v 'https://your.hostname/your/uri' \
-X POST \
-H 'Authorization: Signature 32c64a80d2527dc08906ae1891bac4489509b9f6' \
-d '{
  "notification_type": "dispute",
  "action": "adding",
  "transaction": {
    "id": 123456789,
    "date_create": "2023-08-24T10:21:00+04:00",
    "total": {
      "amount": 1,
      "currency": "EUR"
    },
    "payment_method": "credit_debit_card"
  },
  "settings": {
    "project_id": 18404,
    "merchant_id": 2340
  },
  "user": {
    "id": "1234567",
    "email": "email@example.com",
    "country_code": "US"
  },
  "dispute": {
    "incoming_date": "2024-01-25T01:02:03+04:00",
    "reason": "not_as_described",
    "type": "retrieval",
    "status": "new"
  }
}'

Response samples

application/json

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