Zahlungskonfiguration

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).

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 Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com, 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 Testbankkarten den Bezahlvorgang testen?

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

Kann ich den PayPal-Ablauf in der Testumgebung ausprobieren?

Ja. Ausführliche Informationen finden Sie in der Anleitung.

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.

Payments

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 Nutzer zur Zahlungsmaske der ausgewählten Zahlungsmethode weitergeleitet. Sie finden die Liste der Zahlungsmethoden-IDs im Kundenportal unter Zahlungen > Zahlungsmethoden.

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.

Zusätzlich können Sie den Wert order_id im Parameter external_id übermitteln. Gehen Sie dazu wie folgt vor:

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Projekteinstellungen > Integrationseinstellungen.
2. Aktivieren Sie das Kontrollkästchen Externe ID verwenden.
3. Klicken Sie auf Speichern.

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?

Wofür steht PID?

PID ist die Kennung der Zahlungsmethode aufseiten Xsollas.

Was ist die externe ID?

Die external ID ist die ID einer Transaktion im Spiel. Sie ist einer Bestellung in Ihrem System zugeordnet. Aufseiten von Xsolla ist eine external ID mit einer Transaktions-ID verknüpft. Wenn die Option “Externe ID” aktiviert ist, kann Xsolla wiederholte Zahlungen für dieselbe Transaktion verhindern.

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Projekteinstellungen > Integrationseinstellungen.
2. Klicken Sie unter Zahlungen die notwendigen Kontrollkästchen an:
   • Externe ID verwenden - damit die Validierung der externen ID beim Erstellen eines Tokens erforderlich wird.
   • Verifizierung der externen ID überspringen - damit die Validierung der externen ID beim Erstellen eines Tokens deaktiviert wird.

3. Klicken Sie auf Speichern.

Hinweis

Wenn die Einstellung Externe ID verwenden aktiviert ist, können Sie keine Testzahlung über das Kundenportal durchführen. Um eine Testzahlung erfolgreich durchzuführen, deaktivieren Sie vorübergehend diese Einstellung.

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

Ja. Jede Zahlung muss über eine 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. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zum Menüpunkt Zahlungen > Zahlungseinstellungen > Gateways, um Gateways zu verknüpfen.

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 Customer Success Manager oder senden Sie eine E-Mail an csm@xsolla.com. Zur Gewährleistung der Datensicherheit sollten Sie die PGP-Verschlüsselung verwenden.

Xsolla-PGP-Schlüsselparameter:

• Schlüssel-ID: DA1E62CB
• Schlüsselart: RSA
• Schlüssellänge: 4096
• Fingerabdruck: 0209 8489 757F 4451 F431 FB0C FBFC 4D97 DA1E 62CB
• Benutzer-ID: admins@xsolla.com

 1-----BEGIN PGP PUBLIC KEY BLOCK-----
 2
 3mQINBGnZA+8BEACtu+pO73jhG/5sjmkJRpMxftcQeNZRpB1QUMYYNcB6MFVuU3Oo
 4HO/hOuXWIbh1S5LWQOok5cY3eiQOKwjhwV/IpM0DJ5pxi5YlCAHwkSWO4b2J4lXF
 5pu27bb9whbaC+V1g1gE0TmLtiqKfX0QF6NZop4SrQ3f4yDoV50JKHGtW9XWL4Bfz
 6JWNyM9H4PFdzy5Pwhu5/642XSZf9MClpQzUjwPw+zSfxnweF6je3lbWvH+2fqBG/
 7Y1SeMuFW9Vo9QNCdBX9ws98CrS9bN3frXywh6B1cEEVoBbOvH/T3foKUmlr5gdHi
 8ijTKiFKHTsBcfHcaQgM1cCD0qrRCLrQ2j6KjJOjRevHLJLzdmZFiCDD11+eL338k
 9o4GVdoQR4aNeXfJEICN+79kwz/AVa6d8O934Nnfbz7e7Xx10KR/ObLt6Xnp57GmE
10zWqvtkJ/GGivCyyHR632Nb4yoj/lgf6s0Z0oTQ4Dx8u+as2T+OG+zNo4xRcU8fE2
11F2FBbYXtzp6ySrWu0YcOjS+YhH5tjJBz1dndEQ+FwfA9MWmQgNDuHfdub0CcQqb2
12AfipbGzU+cPucmiyown1WzqP824xmr2JOVJ28DD8CkuAtGQW+kGQqZzHohWgM5WS
13nZlX6rfIYtrygJFrbULGb7A4Ekj9IDzUjnpiHSf8D1jtcHPNPZ2zRvrC3wARAQAB
14tCFYc29sbGEgQWRtaW5zIDxhZG1pbnNAeHNvbGxhLmNvbT6JAlQEEwEIAD4WIQQC
15CYSJdX9EUfQx+wz7/E2X2h5iywUCadkD7wIbLwUJAeEzgAULCQgHAgYVCgkICwIE
16FgIDAQIeAQIXgAAKCRD7/E2X2h5iyxvVD/wLxBbYrNLPuEAJwL8UWDu1naQuaZHl
17/6yDUBV70l7Cxla6KEUqipuJDeD+Vgn85CqVui9eHgZpgXSxG5WogtO+Fkw3n/Ww
18gJkbZQTufWCuW/A82+aHaD0GNCLYqV6EEHQQ4hko6Z3E3zuuI0EoP9hB1BgUq0W1
19qhwrb1Q6Y8nQMgmhCgoRC8EvVFQwk6isvxDczym02/edjxgWuDZJOmZ5WMeN3Vzz
20QoYaGuChoyemigwGvJBKJKAMlgCRZNKlX7L3fOebT16jq1i5ByUqmmngq3YnBnmv
21j76HXP+MQioVr1FC4lkTkD4wWAw/l0gO0B3zLbPY8KQO4gcfLdH6wWPsfcQDmYWK
221vT9AhSPcIQCEcPCZnDBsf6FbiO3KMp0mFCJ0dZdaRJrem/7eL+P3I//H3HKo8RR
23BBGHJZCcm6MSwztUxZW2+6YiMCP9oQVU2zRnUfl/+J6maj83vz9cFQEqYyhbKjTu
24kRkAowUUA54GXnmul+sCvuJXHoKeC4EyZzNYCDxd9Y2u0jAnng2qT09b66IguOZW
250FPSzsRSeHGigwcK+/ChLk0+1CTXmO1fweIsaE1RcqgNLCR4Drtpup2Be8PA3B7i
26Uu8hDz77Lzz8M4O7jDUpS+plUrJEJ1dY+Uiav8jvkeqT9wc89jwKHxNUFNiPhFRb
27cSPnPI9I1QziyLkCDQRp2QPvARAApfXCw+EkrxXY+kOC/WKTen5Z/5hsTlupq2XR
28uF9S//LzVmgPXuVHqMUWUoNs/nfRLwDbJ7CjygL1DKMDSBzPkovaLOhnr4EMvmsP
29CUgQPXP0YUpSYBkAe5idrK2RPegNe68+wEz5r6azHS9r1QjSy+ekXGdTMrAs/On2
30FxxMLWYrEJ8M8iBDQVVOOK8YowcNV44U+ljf5VkJ8TpdNXOATLxuhNXvYTzuDGi6
31J0XCMa3CkIzxC3E4U2qWrHOjU7DjsvqiL5PbtiHjHhCoS6emdPsvqViaIafzcuE5
32eAGiHMyLRl5uwSdAmuW04W+IPM1PM3lwFjFB2lM2f1qHTJXZvG6mXYcBZgrA25te
33dRBgGgpofXutem0jM1lMDLzhAYHhAw8/uJR8yrq2A6t+rIDa1RxP8WJzLASG9rn/
34NmEgor27yhC2RIX4GwJsJ5xSCRkQPxbllVYCVpB6nFfTORbkaWdo7LSwXzUjrJBG
35++m4zQ+rcKRx9XjErls/hYXPB0tZXOP6vYM1zTLqAKtRPeQxJPK5/TbWrVgphvSi
36Yu6qMfnp2IYfyr1Zv0QjxvMUS/A9yVoH1ObY2SJDTa2Wtz1zBX76+vGj4FfeMn2C
37ROIzdvt9ndSYRk2bu/7XtflG7HomE9a/ATqOHalmLykLDgfsQLhSyLKnhOq7MmQw
38ZaQt7hkAEQEAAYkEcgQYAQgAJhYhBAIJhIl1f0RR9DH7DPv8TZfaHmLLBQJp2QPv
39AhsuBQkB4TOAAkAJEPv8TZfaHmLLwXQgBBkBCAAdFiEENKTXmM5UXELlwc4NJVnA
40zu7wAJMFAmnZA+8ACgkQJVnAzu7wAJOsLQ/9Fr7qfXD4EHX/IBrtLvhFiFRoQsUQ
41wp0aI8N2UrGfcWjRCHg7qdYfS5jZTuntNQQIHkVjs3Uqy9K06Va5pbJGCAQv50MW
42qZVKKGuaJ0aM2BsgEzCIIZYAcJpQilcU16A7FIUETMcE7HbubfD6NRW3DDYTBMLd
43Jn9idvd7bRmYCQuCwDMnLfa9JFjt+paCuySUfyCDvFqnO6EXIYQd2JFYptECFEkQ
44crZEfFlA5ygrpUSCsf5lDHgykoVziLbnW1R25dv84OV/Xu3hsjJFAY/TPP1Nh8M6
45JqZjGz5kOcIRThmT28jZdfgeqOnwIAc3rnr4B3NiXuuIJawfltnV5ujmnipcKLK8
46wPJlUAMcCOg3UD5tXjGwPBU8ryHkAZfXsqcUDllA7bGCRMPnQtfTnAr7xrieCjfn
47FDElBPsSg5C2jV9E23/n7+M0MuL/73fYGe8tDleEQHwyRbTEmI+5v4gwt1IOUlg7
485znJdXkp/Kwhmgv4GnFTB78pD+lx3CB0vPFsufhATCY8lDP+xMvUeURDF6jhGP/F
497waM/sOh9/zd4RaOxHMxGZHNs7g9rVca2AbwCTKuTvV7blUz10/j80prEyJwNj5e
50n+td7m4xLHRhSYeSXMteXIowWPE1nshYpV5sZbywE8pOwzBXbqHoNClDQh5szyFB
51CyHQR8sowp+42FLUFw/+PdDSjmI7/Z3vmtRsi+VgqbDM7CW2T8rIR/sUizBOCRah
52mBM1aA7IyJ2GerdMFGVeCRcCljUEiGnw+IvPdS72bTpfvk+8fU2o7PXsQSJfmhQS
53cA4k9uhLm87S3Ng5SX50+qTsgZgc7qywoSqCs4KC7p5zmsc+hfmdpFFmBYTP24Ai
54WdCXt1fqAAsbbO9dU5mos2Hs/L6qANKaN0wJBwf/cRnrewdV6zVhLCvkDYuXADf8
55SmgzXCESVNZNEFLWC2+syl3McSaRbjaInf1ijB8oMI7zR32bonqTEw4Vxc+mcc7H
56ck3ZtYyE8iA8TU5yyNzv0bmD5b8S7EquXekhbckC6tZw/i+O6xt6sZNnczkGbvup
57v5MNf4h8bcCkMFZ1jD27wpLUyGbxyr9t0D4DJeDYaAIyDF2IWd4kAeHvUyRvJt+b
58mbDI6b00PHMlW5JGebVvaV5opeBn2/aYTAMg5T7ohHxksM6jWfIVJPMRTik6RsGC
5937yLy8U7gcxebRwty6GxZuDdRjaBz/JcC9TshTgvbWJ392t8O3ZU6mezV2yDHTAO
60dE30NoqxiX+sZTYsyL5hkSW44LiH5sd30HxyXLQQ1Q+k3y0drKbp9UNc3E79l/mX
61r6jr1egiuYyCUk2zjaUx+UfI7Xrk2uttanFgJsTTX2wIGic5iFEecfe45V/YgOM=
62=naL7
63-----END PGP PUBLIC KEY BLOCK-----

Wie wird das Land des Nutzers ermittelt?

Wenn Sie den clientseitigen API-Aufruf zur Generierung des Zahlungstokens verwenden, ermittelt Xsolla das Land des Nutzers anhand der IP-Adresse, von der die Anfrage stammt.

Wenn Sie den serverseitigen API-Aufruf zur Generierung des Zahlungstokens verwenden, wird das Land anhand der folgenden Kriterien ermittelt:

• anhand des Werts des Parameters user.country.value im Anfragerumpf
• anhand der IP-Adresse im Header X-User-Ip

Wenn keiner der beiden Werte übermittelt wird, erscheint eine Fehlermeldung. Werden beide Werte übermittelt, werden die Informationen aus dem Anfragerumpf verwendet.