Xsolla-logo

ZahlungWebhook POST

Wird versendet, wenn ein Benutzer eine Zahlung abschließt. Enthält Zahlungsdaten.

Request
Request Body schema: application/json
notification_type
required
string

Art der Benachrichtigung.

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.

payment_date
string

Zahlungsdatum.

payment_method
integer

ID der Zahlungsart.

payment_method_name
string

Name der Zahlungsmethode.

payment_method_order_id
string

Zahlungs-ID im Zahlungssystem.

required
object

Zahlungsdaten (Objekt).

object

Direkte Quellensteuer.

amount
integer <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

percent
integer <float>

Direkter Quellensteuersatz.

object

Vom Benutzer entrichteter Betrag (Objekt).

amount
integer <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Gebühren des Zahlungssystems.

amount
integer <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Betrag, der vom Zahlungssystem abgebucht wird.

amount
integer <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Details zur Auszahlung (Objekt).

amount
integer <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

payout_currency_rate
integer <float>

Wechselkurs zwischen Zahlungs- und Auszahlungswährung.

object

Objekt mit Daten über die Rückübertragungskosten, die Xsolla von Dritten auferlegt wurden.

amount
integer <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Sales Tax (Objekt; nur in den USA und Kanada).

amount
integer <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

percent
integer <float>

Sales-Tax-Steuersatz.

object

Angaben zur MwSt. (Objekt, nur in der EU).

amount
integer <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

percent
integer <float>

Mehrwertsteuersatz.

object

Betrag, der vom Xsolla-Konto abgebucht wird.

amount
integer <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Xsolla-Gebühr (Objekt).

amount
integer <float>

Betrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

custom_parameters
object

Ihre benutzerdefinierten Parameter.

object

Objekt, welches Angaben zum Kauf enthält.

required
object

Gesamtpreis des Einkaufs (Objekt).

amount
integer <float>

Gesamtbetrag der Zahlung.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Objekt, welches Angaben zur Bezahlung enthält.

amount
integer <float>

Kaufbetrag.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object

Angaben zum Gutschein (Objekt; falls ein Gutschein bei Abschluss des Abonnements genutzt wurde).

campaign_code
string

Kampagne.

coupon_code
string

Gutscheincode.

object

Benutzerdaten (Objekt).

giver_id
string

Spender-ID.

hide_giver_from_receiver
string

Legt fest, ob die Identität des Spenders vor dem Beschenkten geheim gehalten werden soll.

message
string

Nachricht vom Spender.

receiver_email
string

E-Mail des Geschenkempfängers.

receiver_id
string

ID des Geschenkempfängers.

object
Deprecated

Spielschlüssel (Array).

amount
integer <float>
Deprecated

Preis.

currency
string
Deprecated

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

digital_content
string
Deprecated

Im Kundenportal festgelegte Spiel-SKU.

drm
string
Deprecated

Die für den Vertrieb des Spiels genutzte DRM-Plattform. Stellen Sie sicher, dass die erforderlichen DRM-Plattformen im Kundenportal konfiguriert sind.

Enum: "steam" "playstation" "xbox" "uplay" "origin" "drmfree" "gog" "epicgames" "nintendo_eshop" "discord_game_store" "oculus"
object
Deprecated

Objekt mit Upgrade-Daten.

amount
integer <float>
Deprecated

Preis in echter Währung.

currency
string
Deprecated

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

object
Deprecated

Objekt mit Daten über das Paket, von dem aus der Benutzer ein Upgrade durchgeführt hat.

DRM
string
Deprecated

DRM-Plattform des Spiels.

digital_content
string
Deprecated

Im Kundenportal festgelegte Spiel-SKU.

object
Deprecated

Objekt mit Daten über das Paket, auf das der Benutzer ein Upgrade durchgeführt hat.

DRM
string
Deprecated

DRM-Plattform des Spiels.

digital_content
string
Deprecated

Im Kundenportal festgelegte Spiel-SKU.

Array of objects

Werbeaktionen, die bei dieser Transaktion Verwendung finden.

Array
id
integer

ID der Werbeaktion.

technical_name
string

Arbeitstitel der Werbeaktion.

object

Angaben zum Abonnement (Objekt).

amount
integer <float>

Preis in echter Währung.

currency
string

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

date_create
string

Datum, an dem das Abonnement abgeschlossen wurde. Datums- und Zeitangabe gemäß ISO 8601.

date_next_charge
string

Nächstes Rechnungsdatum. Datums- und Zeitangabe gemäß ISO 8601.

plan_id
string

ID des Abo-Modells (extern, falls das Abo-Modell über die API angelegt wurde).

product_id
string

Produkt-ID (falls sie im Zugriffstoken versendet wurde).

subscription_id
integer

In der Xsolla-Datenbank erfasste Abonnement-ID.

tags
Array of strings

Abo-Modell-Markierungen.

object
Deprecated

Zu erwerbende virtuelle Währung (Objekt).

amount
integer <float>
Deprecated

Preis in echter Währung.

currency
string
Deprecated

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

name
string
Deprecated

Name der virtuellen Währung.

quantity
integer <float>
Deprecated

Menge.

sku
string
Deprecated

SKU des virtuellen Währungspakets (falls für das Angebotspaket festgelegt).

object
Deprecated

Die beim Kauf erworbenen virtuellen Gegenstände.

amount
integer <float>
Deprecated

Kaufbetrag.

currency
string
Deprecated

Währung. Währungscode, bestehend aus drei Buchstaben gemäß ISO 4217.

Array of objects
Deprecated
Array
amount
integer <float>
Deprecated

Gegenstandsmenge.

sku
string
Deprecated

ID des Gegenstands.

object

Benutzerdefinierte Projekteinstellungen (Objekt).

merchant_id
integer

Händler-ID.

project_id
integer

Xsolla-ID des Spiels. Kann im Kundenportal eingesehen werden.

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
application/json
{
  • "custom_parameters": { },
  • "notification_type": "string",
  • "payment_details": {
    },
  • "purchase": {
    },
  • "settings": {
    },
  • "transaction": {
    },
  • "user": {
    }
}
Response samples
application/json
{
  • "error": {
    }
}