Zahlung

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

Payload
CURL
PHP
HTTP

application/json

{"custom_parameters": { },
"notification_type": "string",
"payment_details": {"direct_wht": {"amount": 0,
"currency": "string",
"percent": 0
},
"payment": {"amount": 0,
"currency": "string"
},
"payment_method_fee": {"amount": 0,
"currency": "string"
},
"payment_method_sum": {"amount": 0,
"currency": "string"
},
"payout": {"amount": 0,
"currency": "string"
},
"payout_currency_rate": 0,
"repatriation_commission": {"amount": 0,
"currency": "string"
},
"sales_tax": {"amount": 0,
"currency": "string",
"percent": 0
},
"vat": {"amount": 0,
"currency": "string",
"percent": 0
},
"xsolla_balance_sum": {"amount": 0,
"currency": "string"
},
"xsolla_fee": {"amount": 0,
"currency": "string"
}
},
"purchase": {"checkout": {"amount": 0,
"currency": "string"
},
"coupon": {"campaign_code": "string",
"coupon_code": "string"
},
"gift": {"giver_id": "string",
"hide_giver_from_receiver": "string",
"message": "string",
"receiver_email": "string",
"receiver_id": "string"
},
"pin_codes": {"amount": 0,
"currency": "string",
"digital_content": "string",
"drm": "steam",
"upgrade": {"amount": 0,
"currency": "string",
"digital_content_from": {"DRM": "string",
"digital_content": "string"
},
"digital_content_to": {"DRM": "string",
"digital_content": "string"
}
}
},
"promotions": [{"id": 0,
"technical_name": "string"
}
],
"subscription": {"amount": 0,
"currency": "string",
"date_create": "string",
"date_next_charge": "string",
"plan_id": "string",
"product_id": "string",
"subscription_id": 0,
"tags": ["string"
]
},
"total": {"amount": 0,
"currency": "string"
},
"virtual_currency": {"amount": 0,
"currency": "string",
"name": "string",
"quantity": 0,
"sku": "string"
},
"virtual_items": {"amount": 0,
"currency": "string",
"items": [{"amount": 0,
"sku": "string"
}
]
}
},
"settings": {"merchant_id": 0,
"project_id": 0
},
"transaction": {"agreement": 0,
"dry_run": 0,
"external_id": "string",
"id": 0,
"payment_date": "string",
"payment_method": 0,
"payment_method_name": "string",
"payment_method_order_id": "string"
},
"user": {"country": "string",
"email": "string",
"id": "string",
"ip": "string",
"name": "string",
"phone": "string",
"zip": "string"
}
}

Response samples

application/json

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