FAQs

Integration

Wie öffne ich die Bezahlstation in einem iframe?

Wir empfehlen Ihnen, das Zahlungsportal mithilfe des Skripts Pay Station Embed in einer Lightbox zu öffnen. Mit diesem Skript können Sie:

  • automatische die Größe des Zahlungsportals und den Gerätetyps (Desktop, Mobile) bestimmen
  • automatisch Ereignisse aus dem Zahlungsportal empfangen
  • das Benutzeroberflächen-Theme ändern

So öffnen Sie das Zahlungsportal in einem iframe:

  1. Implementieren Sie den postMessage-Mechanismus, um Ereignisse aus dem Zahlungsportal empfangen zu können.
  2. Rufen Sie einen Token ab. Übermitteln Sie in der Anfrage:
    • den Gerätetyp (Desktop oder Mobile) im Parameter settings.ui.version
    • die Größe des Zahlungsportals im Parameter settings.ui.size:

Bezahlstation-GrößeIframe-Breite
Groß (Standard)670–850 px
Mittel590–740 px
Klein510–630 px

  1. Öffnen Sie das Zahlungsportal über den Link https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN, wobei ACCESS_TOKEN der erhaltene Token ist.

Welche Xsolla-IP-Adressen muss ich zum Zwecke der Webhook-Konfiguration auf die weiße Liste setzen?

Sie müssen Webhooks von den folgenden IP-Adressen empfangen und verarbeiten können:

  • 185.30.20.0/24
  • 185.30.21.0/24
  • 185.30.23.0/24

Wenn Sie das Login-Produkt integriert haben, müssen zusätzlich Webhooks von der IP-Adresse 34.94.11.35 verarbeiten können.

Gibt es ein SDK für Node.JS/C#/Ruby/Java/ASP usw.?

Zurzeit gibt es SDKs für PHP und Android. Sie können Ihr eigenes SDK mit jeder beliebigen Programmiersprache/Plattform erstellen, solange es über HTTPS-Request-Funktionalität verfügt.

Benutzervalidierung

Was ist eine Benutzer-ID?

Die Benutzer-ID ist ein Parameter, anhand dem man einen Benutzer in einem Spiel identifizieren kann. Sie können Benutzer-IDs in einer Datenbank speichern. Wenn Sie ungültige Benutzer-IDs erhalten, lösen Sie eine Ausnahme aus. Ein Beispiel für eine Benutzervalidierung finden Sie im GitHub-Repository.

Welche Daten sollte ich nach Abschluss der Validierung zurückgeben?

Geben Sie bei einer erfolgreichen Validierung den HTTP-Code 200 zurück bzw. im Falle eines Fehlers den Code 400 (INVALID_USER).

Projekteinstellungen

Muss ich für jede Umgebung (QA, Staging, Produktion) neue Projekte erstellen?

Wir empfehlen, separate Projekte zu Testzwecken zu erstellen, um die Produktionsumgebung nicht zu beeinträchtigen.

Was ist der Unterschied zwischen einem geheimen Schlüssel, einem Projektschlüssel und einem API-Schlüssel?

Ein geheimer Schlüssel und ein Projektschlüssel sind dasselbe. Er wird für die digitale Signatur verwendet und ist bei der Verarbeitung sicherer Zahlungen erforderlich. Der JSON-Rumpf der Anfrage wird mit diesem Schlüssel verknüpft und das Ergebnis mit dem SHA-1-Algorithmus gehasht.

Der API-Schlüssel ist für alle Projekte in Ihrem Konto derselbe und wird für API-Aufrufe gegenüber dem Xsolla-Server verwendet. Dieser Schlüssel muss auf Ihrem eigenen Server gespeichert sein, niemals in Binärdateien oder im Frontend.

Was ist der Unterschied zwischen einer Webhook-URL und einer Rückgabe-URL?

Eine Webhook-URL ist die URL-Adresse Ihres Webhook-Servers, an den die Benachrichtigungen gesendet werden. Eine Rückgabe-URL ist die URL-Adresse, an die ein Benutzer nach erfolgter Zahlung weitergeleitet wird.

Wo finde ich die Projekt-ID?

Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zu Projekteinstellungen > Allgemeine Einstellungen.

Wo finde ich die Händler-ID?

Öffnen Sie das Kundenportal, und navigieren Sie zu Firmeneinstellungen > Firma.

Hinweis
Die Händler-ID und die Publisher-ID sind identisch.

Wo finde ich den API-Schlüssel?

Öffnen Sie das Kundenportal, und navigieren Sie zu Firmeneinstellungen > API-Schlüssel.

Webhook-Einstellungen

Muss ich HTTPS für ein Webhook-Protokoll verwenden?

Ja.

Warum wurde die Xsolla-Benachrichtigung nicht an die Webhook-URL gesendet?

Prüfen Sie, ob Ihr Webhook-Server die erforderlichen Arten von HTTP-Anfragen (POST, GET) unterstützt.

Warum werden keine Webhooks an meine mobile App gesendet?

Webhooks werden nur an eine einzige URL-Adresse gesendet, die in den Projekteinstellungen angegeben ist. Da es sich um eine Server-zu-Server-Kommunikation handelt, können Webhooks nicht an mehrere URL-Adressen gesendet werden. Wenn Sie in Ihrem Spiel, auf Ihrer Website oder in Ihrer mobile App Benachrichtigungen erhalten möchten, müssen Sie auf Ihrem Server den Webhook-Versand einrichten, damit Sie Daten zwischen Xsolla und Ihrem Spiel übermitteln können.

Personalisierung

Kann ich das Zahlungsportal-Theme anpassen?

Sie können das dunkles Theme aktivieren, indem Sie settings.ui.theme = default_dark im Token übermitteln. Das dunkle Theme erlaubt es Ihnen zudem, das Hintergrundbild festzulegen oder die Hintergrundfarbe nach Belieben zu ändern (siehe die Demo). Kontaktieren Sie Ihren Account Manager, wenn Sie andere Einstellungen ändern möchten.

Kann ich das Design von E-Mails, welche an Nutzer gesendet werden, ändern?

Ja. Befolgen Sie die Anleitung über das Individualisieren von E-Mails. Die Reihenfolge der E-Mail-Elemente kann nicht geändert werden, da sie Teil einer Standardvorlage sind. Dies ist gemäß der mit Xsolla getroffenen Lizenzvereinbarung vorgeschrieben. Xsolla fungiert hierbei als „Merchant of Record“.

Testen

Kann ich mit Testkarten den Zahlungsvorgang testen?

Ja, aber nur, wenn Sie Ihre Anwendung oder die Bezahlstation-Demo in der Testumgebung ausführen. Werfen Sie einen Blick auf die allgemeine Liste der Testkarten verschiedener Marken und Ausgabeländer.

Kann ich den PayPal-Ablauf in der Testumgebung ausprobieren?

Ja, Sie können ein erfolgreiches PayPal-Zahlungsszenario ausprobieren. Ausführliche Informationen können Sie in der Anleitung lesen.

Wie teste ich die Erstattung einer Zahlung?

Sie können Erstattungen über den API-Aufruf "Erstattung anfordern" testen. Weitere Informationen finden Sie in der Anleitung.

Wofür steht "Xsolla-Rechnungs-ID" und "Rechnungs-ID" auf der Registerkarte, auf der man Webhooks testet?

Bei der Xsolla-Rechnungs-ID handelt es sich um die Transaktions-ID aufseiten Xsollas. Zum Testen können Sie einen beliebigen numerischen Wert eingeben.

Bei der Rechnungs-ID handelt es sich um eine optionale Transaktions-ID in Ihrem Spiel. Zum Testen können Sie eine beliebige Kombination aus Buchstaben und Ziffern eingeben.

Zahlungen

Wie validiere ich eine in einem Webhook erhaltene Zahlungsanfrage?

Prüfen Sie zunächst, ob die angegebene Benutzer-ID in Ihrem Projekt existiert. Geben Sie dann den Code 200 zurück, um die Zahlung zu bestätigen.

Kann ich einen Nutzer zu einer bestimmten Zahlungsmethode weiterleiten?

Beim Öffnen des Shops können Sie die Zahlungsmethoden-ID im Parameter settings.payment_method übermitteln. In diesem Fall werden die Benutzer zur Zahlungsmaske der ausgewählten Zahlungsmethode weitergeleitet. Sie finden die Liste der Zahlungsmethoden-IDs im Kundenportal unter Bezahlstation > Zahlungsarten oder durch Aufruf der API-Methode Zahlungsarten anfordern.

Kann Ich einen Nutzer direkt auf eine Seite im Stil von "Zahlung erfolgreich/fehlgeschlagen" weiterleiten, nachdem eine Zahlung erfolgt ist?

Ja, Sie können die Weiterleitungsbedingungen konfigurieren. Weitere Informationen dazu finden Sie in der Anleitung.

Unser Abrechnungssystem vergibt automatisch bei jeder Bestellung eine order_id. Können wir beim Empfang von Token die order_id anstelle der user_id verwenden?

Nein, Sie benötigen die user_id, damit alles ordnungsgemäß funktioniert.

Sie können die order_id im Parameter external_id übermitteln. Gehen Sie dazu wie folgt vor:

  1. Öffnen Sie das Kundenportal.
  2. Navigieren Sie zu Bezahlstation > Einstellungen.
  3. Scrollen Sie zu Sonstige Einstellungen, und stellen Sie den Umschalter Externe Transaktions-ID auf Ein.

Kann ich bei jeder Transaktion die Webhook-URL überschreiben?

Nein, die Webhook-URL für alle Transaktionen wird im Kundenportal in den Projekteinstellungen festgelegt.

Erhalte ich Einzelheiten zur fehlgeschlagenen Transaktionen?

Nein, Xsolla sendet nur Webhooks bei erfolgreichen Transaktionen. Wenn Sie eine Benachrichtigung über eine Zahlung erhalten haben, bedeutet das, dass die Transaktion erfolgreich war.

Wie erhebe ich die MwSt. auf den Gesamtzahlungsbetrag?

Die Mehrwertsteuereinstellungen sind standardmäßig aufseiten von Xsolla konfiguriert. Wenden Sie sich an Ihren Account Manager, wenn Sie die Einstellungen ändern und die Mehrwertsteuer auf den Gesamtbetrag der Zahlung eines Benutzers aufschlagen möchten.

Wofür steht PID?

PID ist die Kennung der Zahlungsmethode aufseiten Xsollas.

Wie aktualisiere ich das virtuelle Währungsguthaben eines Nutzers?

Um das Guthaben eines Benutzers zu ändern, rufen Sie die API-Methode Benutzer-Kontostand aktualisieren auf.

Was ist die externe ID?

Die externe ID ist eine Transaktions-ID aus dem Spiel.

Muss ich für jede Transaktion eine neue externe ID generieren?

Ja. Jede Zahlung muss über eindeutige externe ID verfügen.

Welchen Wert muss ich für die Methode setExternalPaymentId festlegen?

Die Methode setExternalPaymentId sollte denselben Wert aufweisen wie die external_id, sofern eine vorliegt.

Was sind Gateways?

Sobald Sie eine Vereinbarung mit einem Zahlungssystem geschlossen haben, können Sie Gateways verwenden, um diese Zahlungsmöglichkeiten im Zahlungsportal anzuzeigen. Die Spieler können weiterhin mit den ausgewählten Zahlungsmethoden bezahlen, wobei Sie die Auszahlungen direkt von diesen Zahlungssystemanbietern erhalten. Um Gateways zu verbinden, öffnen Sie Ihr Projekt im Kundenportal, und wechseln Sie zum Abschnitt Bezahlstation > Gateways.

Xsolla fungiert als technischer Dienstleister und erhält eine geringe Einnahmebeteiligung: 1,25 % des Transaktionsbetrages + 0,10 $. Sie haben uneingeschränkten Zugang zu allen Xsolla-Lösungen, sind aber für Folgendes verantwortlich:

  • für steuerliche Belange
  • Unterzeichnung separater Vereinbarungen mit jedem Zahlungssystem
  • Einbehaltung von direkt aus dem Zahlungssystem eingehendem Geld
  • Verwaltung der Zahlungssystemgebühren, Rückbuchungen, Erstattungen, Auszahlungsprovisionen und Betriebskosten

Wenn Sie beispielsweise PayPal nutzen und es als Zahlungsmethode einrichten möchten, können Sie ein Gateway verbinden. Das Zahlungsportal ändert sich nicht – die Änderungen betreffen nur das Auszahlungsverfahren. Nach der Verarbeitung einer Zahlung wird das Geld des Spielers auf Ihr PayPal-Konto überwiesen. In diesem Fall ist Xsolla nicht in das Auszahlungsverfahren involviert.

Wie kann ich Benutzerdaten (gespeicherte Zahlungskonten, Abonnements usw.) zu Xsolla migrieren?

Wenden Sie sich an Ihren Account Manager. Zur Gewährleistung der Datensicherheit sollten Sie die PGP-Verschlüsselung verwenden.

Fehlermeldungen

Hinweis
In der Dokumentation finden Sie weitere Informationen zu möglichen Fehlern beim Öffnen des Zahlungsportals.

Was sollte ich tun, wenn ich die Fehlermeldung 0004-0008 erhalte?

Prüfen Sie, ob Sie die korrekte URL-Adresse verwenden:

  • Nutzen Sie den folgenden Link, um das Zahlungsportal in der Testumgebung zu öffnen: https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN, wobei ACCESS_TOKEN der erhaltene Token ist.
  • Nutzen Sie den folgenden Link, um echte Zahlungen vorzunehmen: https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN, wobei ACCESS_TOKEN der erhaltene Token ist.

Was sollte ich tun, wenn ich die Fehlermeldung 2205 oder 2207 erhalte (Benutzer-ID-Fehler)?

  • Übermitteln Sie eine gültige Benutzer-ID (user_id) aus Ihrer Datenbank.
  • Empfehlungen zur Verwendung von Webhooks:
    • Wenn Sie auf Webhooks verzichten möchten, sollten Sie sie in Ihrem Projekt deaktivieren. Wechseln Sie dazu ins Kundenportal, navigieren Sie zu Projekteinstellungen > Webhooks, und stellen Sie den Schalter auf Aus.
    • Wenn Sie Webhooks verwenden möchten, implementieren Sie die erfolgreiche Verarbeitung des Webhooks für die Benutzervalidierung.

Was sollte ich tun, wenn ich die Fehlermeldung 1000-0003 erhalte?

Aktivieren Sie das entsprechende Modul für Ihr Projekt.

Was sollte ich tun, wenn ich die Fehlermeldung 0002-0004 erhalte?

Unterschreiben Sie die Xsolla-Lizenzvereinbarung, um Ihre Gelder auszahlen zu können. Wenn Sie Hilfe benötigen, kontaktieren Sie Ihren Account Manager oder senden Sie eine E-Mail an onboarding@xsolla.com.

Was sollte ich tun, wenn ich die Fehlermeldung 3032 erhalte?

Senden Sie Informationen über fehlerhafte Zahlungstoken oder Benutzer- und Projekt-IDs über einen der verfügbaren Kommunikationskanäle an das Integrationsteam.

Hinweis
Den Zahlungstoken finden Sie in der URL-Adresse des geöffneten Zahlungsportals. Ist das Zahlungsportal in einem iframe geöffnet, klicken Sie mit der rechten Maustaste auf den iframe und wählen Sie aus der Drop-down-Liste eine Option, mit der Sie die Quelle des iframe anzeigen können.

Warum fehlt der Autorisierungs-Header in der Webhook-Anfrage?

Um diesen Fehler zu beheben, müssen Sie die Apache-Datei .htaccess oder httpd.conf editieren. Weitere Informationen finden Sie in der SDK-Dokumentation.

Kontaktdaten

Wenn Sie in der FAQ keine Antwort auf Ihre Fragen finden, können Sie uns auch über andere Kanäle kontaktieren:
  • Klicken Sie unten rechts auf das Chat-Symbol, um das Integrationsteam über einen Messenger zu kontaktieren. Auf diese Weise können wir Ihr Problem in Echtzeit lösen.
  • E-Mail an integration@xsolla.com.
  • Wenden Sie sich an Ihren Account Manager.
  • Kontaktieren Sie einen Integrationsspezialisten über Basecamp.
Kundendienst-Integrationsleitfaden (PDF)
Informieren Sie sich über Möglichkeiten, unser Kundendienstteam zu integrieren.
War dieser Artikel hilfreich?
Vielen Dank!
Gibt es etwas, das wir verbessern können? Nachricht
Das tut uns leid
Bitte erläutern Sie, weshalb dieser Artikel nicht hilfreich ist. Nachricht
Vielen Dank für Ihr Feedback!
Wir werden Ihr Feedback aufgreifen und dazu nutzen, Ihr Erlebnis verbessern.
Diese Seite bewerten
Diese Seite bewerten
Gibt es etwas, das wir verbessern können?

Jetzt nicht

Vielen Dank für Ihr Feedback!
Letztmalig aktualisiert: 25. August 2022

Haben Sie einen Tippfehler oder einen anderen Textfehler gefunden? Wählen Sie den Text aus und drücken Sie Strg+Eingabe.

Problem melden
Wir überprüfen unsere Inhalte ständig. Ihr Feedback hilft uns, sie zu verbessern.
Geben Sie eine E-Mail-Adresse an, damit wir Sie erreichen können
Vielen Dank für Ihr Feedback!