Bestellung aufseiten des Anwendungs-Clients anlegen

Verwenden Sie den API-Aufruf Bestellung mit angegebenem Artikel anlegen, um eine Bestellung mit Nutzer- und Artikeldaten aufseiten von Xsolla anzulegen. Die Methode antwortet mit einem Zahlungstoken, der benötigt wird, um das Zahlungsportal zu öffnen und die Zahlung abzuschließen. Übermitteln Sie den Parameter “sandbox”: true im Rumpf der Token-abrufen-Anfrage, um in die Testumgebung zu wechseln.

Zahlungsportal öffnen

<script>
   var options = {
       access_token: 'ACCESS_TOKEN', //TODO use access token, received on previous step
       sandbox: true //TODO please do not forget to remove this setting when going live
   };
   var s = document.createElement('script');
   s.type = "text/javascript";
   s.async = true;
   s.src = "https://static.xsolla.com/embed/paystation/1.0.7/widget.min.js";
   s.addEventListener('load', function (e) {
       XPayStationWidget.init(options);
   }, false);
   var head = document.getElementsByTagName('head')[0];
   head.appendChild(s);
</script>

<button data-xpaystation-widget-open>Buy Credits</button>

Bezahlvorgang testen

Den Bezahlvorgang können Sie im Sandbox-Modus testen. Die Sandbox ist eine eigenständige Testumgebung, welche alle Funktionen der Live-Umgebung, mit Ausnahme echter und abgelehnter Zahlungen, unterstützt. Die Testumgebung aktivieren Sie, indem Sie “sandbox”: true beim Erstellen eines Tokens senden.

1. Rufen Sie das Zahlungsportal in der Testumgebung auf.
2. Wählen Sie Bankkarte als Zahlungsmethode.
3. Geben Sie die Bankkartendaten ein. In die anderen Felder (z. B. Name oder Adresse) können Sie beliebige Daten eingeben. Sie können auch falsche Angaben (Kartennummer oder Ablaufdatum) machen, um zu testen, ob ein Fehler generiert wird.
4. Klicken Sie auf Zahlen.

Liste der Testkarten

Sehen Sie sich die komplette Liste der verfügbaren Testbankkarten an.

So zeigen Sie die in der Testumgebung getätigten Transaktionen an:

1. Öffnen Sie Ihr Kundenportal.
2. Navigieren Sie zu Finanzen > Transaktionsregister.
3. Klicken Sie das Kästchen Testtransaktionen anzeigen an.

Bestellung anlegen und Zahlungsportal öffnen

Rufen Sie die SDK-Methode XsollaCatalog.Purchase auf, und übermitteln Sie die folgenden Parameter, um eine Bestellung mitsamt Nutzer- und Produktdaten aufseiten von Xsolla anzulegen:

• itemSku – die SKU des Artikels, den der Nutzer kaufen möchte.
• onSuccess – der Rückruf bei einem erfolgreichen Kauf. Wird ausgelöst, wenn sich der Bestellstatus in done ändert.
• onError – der Rückruf bei Anfragefehlern.
• onBrowseClosed – der Rückruf beim Schließen des Browsers (optional). Das Ereignis wird nur getrackt, wenn der Nutzer das Zahlungsportal im integrierten Browser öffnet. Ereignisse in externen Browsern werden nicht getrackt.
• purchaseParams – Kaufparameter und Nutzereinstellungen für das Zahlungsportal, z. B. Gebietsschema und Währung (optional).
• customHeaders – benutzerdefinierte Anfrage-Header (optional).

Die Methode XsollaCatalog.Purchase initiiert den Kaufvorgang für den angegebenen Artikel: Es wird eine Bestellung angelegt, das Zahlungsportal geöffnet und der Bestellstatus getrackt. Übermitteln Sie im Parameter onSuccess eine Funktion, die aufgerufen wird, wenn sich der Bestellstatus in done ändert.

Bezahlvorgang testen

Den Bezahlvorgang können Sie im Sandbox-Modus testen. Die Sandbox ist eine eigenständige Testumgebung, welche alle Funktionen der Live-Umgebung, mit Ausnahme echter und abgelehnter Zahlungen, unterstützt. Die Testumgebung aktivieren Sie, indem Sie in Unity Editor im Inspector-Fenster das Kontrollkästchen Test Payments Mode aktivieren (ist standardmäßig aktiviert).

1. Führen Sie Ihre Anwendung oder Ihre Szene in Unity Editor aus.
2. Wählen Sie Bankkarte als Zahlungsmethode.
3. Geben Sie die Bankkartendaten ein. In die anderen Felder (z. B. Name oder Adresse) können Sie beliebige Daten eingeben. Sie können auch falsche Angaben (Kartennummer oder Ablaufdatum) machen, um zu testen, ob ein Fehler generiert wird.
4. Klicken Sie auf Zahlen.

Liste der Testkarten

Sehen Sie sich die komplette Liste der verfügbaren Testbankkarten an.

So zeigen Sie die in der Testumgebung getätigten Transaktionen an:

1. Öffnen Sie Ihr Kundenportal.
2. Navigieren Sie zu Finanzen > Transaktionsregister.
3. Klicken Sie das Kästchen Testtransaktionen anzeigen an.

Bestellung anlegen und Zahlungsportal öffnen

1. Rufen Sie die Methode createOrderByItemSku aus der Store-Bibliothek auf, und übermitteln Sie die folgenden Parameter, um eine Bestellung mitsamt Nutzer- und Artikeldaten aufseiten von Xsolla anzulegen:

1. • callback – der Rückruf bei erfolgreicher Bestellanlegung. Erhält den Zahlungstoken, der zum Öffnen des Zahlungsportals und zur Abwicklung der Zahlung erforderlich ist.

1. • itemSku – die SKU des Artikels, den der Nutzer kaufen möchte.

1. • options – Zahlungsparameter (optional).

1. • quantity – Wie viele Artikel der Nutzer kaufen möchte (optional). Ist keine Menge angegeben, gilt der Standardwert 1.

2. Implementieren Sie die Logik des Zahlungsportals:

val intent = XPayments.createIntentBuilder(activity)
    .accessToken(AccessToken(<payment token>))
    .isSandbox(<isSandbox>)
    .build()
startActivityForResult(intent, RC_PAYSTATION)

3. Implementieren Sie die Handhabung der Zahlungsergebnisse:

override fun onActivityResult(requestCode: Int, resultCode: Int, data: Intent?) {
    super.onActivityResult(requestCode, resultCode, data)
    if (requestCode == RC_PAYSTATION) {
        val (status, _) = XPayments.Result.fromResultIntent(data)
        when (status) {
            XPayments.Status.COMPLETED -> Log.d("MainActivity", "Payment completed")
            XPayments.Status.CANCELLED -> Log.d("MainActivity", "Payment cancelled")
            XPayments.Status.UNKNOWN -> Log.d("MainActivity", "Status unknown")
        }
    }
}

Bezahlvorgang testen

Den Bezahlvorgang können Sie im Sandbox-Modus testen. Die Sandbox ist eine eigenständige Testumgebung, welche alle Funktionen der Live-Umgebung, mit Ausnahme echter und abgelehnter Zahlungen, unterstützt. Die Testumgebung aktivieren Sie, indem Sie beim Erstellen des Objekts IntentBuilder die Methode isSandbox aufrufen und true als Argument übermitteln.

1. Führen Sie Ihre Anwendung aus.
2. Wählen Sie Bankkarte als Zahlungsmethode.
3. Geben Sie die Bankkartendaten ein. In die anderen Felder (z. B. Name oder Adresse) können Sie beliebige Daten eingeben. Sie können auch falsche Angaben (Kartennummer oder Ablaufdatum) machen, um zu testen, ob ein Fehler generiert wird.
4. Klicken Sie auf Zahlen.

Liste der Testkarten

Sehen Sie sich die komplette Liste der verfügbaren Testbankkarten an.

So zeigen Sie die in der Testumgebung getätigten Transaktionen an:

1. Öffnen Sie Ihr Kundenportal.
2. Navigieren Sie zu Finanzen > Transaktionsregister.
3. Klicken Sie das Kästchen Testtransaktionen anzeigen an.

Bestellung anlegen und Zahlungsportal öffnen

1. Rufen Sie die SDK-Methode FetchPaymentToken auf, und übermitteln Sie die folgenden Parameter, um eine Bestellung mitsamt Nutzer- und Artikeldaten aufseiten von Xsolla anzulegen:

1. • AuthToken – der bei der Authentifizierung gegenüber Xsolla Login erhaltene Benutzerauthentifizierungstoken.

1. • ItemSKU – die SKU des Artikels, den der Nutzer kaufen möchte.

1. • SuccessCallback – der Rückruf, der bei erfolgreichem Erhalt des Zahlungstokens ausgelöst wird.

1. • ErrorCallback – der Rückruf bei einem Anfragefehler.

1. • PurchaseParams – Kaufparameter und Nutzereinstellungen für das Zahlungsportal, z. B. Gebietsschema und Währung (optional).

2. Implementieren Sie den Aufruf des Zahlungsportals. Rufen Sie dazu die SDK-Methode LaunchPaymentConsole auf, und übermitteln Sie die folgenden Parameter:

1. • WorldContextObject – das Weltkontext-Objekt (für C++-Aufrufe).

1. • OrderId – die Bestell-ID.

1. • AccessToken – der Zahlungstoken.

1. • SuccessCallback – der Rückruf, der bei erfolgreichem Erhalt des Zahlungstokens ausgelöst wird.

1. • ErrorCallback – der Rückruf bei einem Anfragefehler.

1. • BrowserClosedCallback – der Rückruf beim Schließen des Browsers. Das Ereignis wird nur getrackt, wenn der Nutzer das Zahlungsportal im integrierten Browser öffnet. Ereignisse in externen Browsern werden nicht getrackt.

1. • PayStationVersion – die Pay-Station-Version. Standardmäßig wird die Version 4 verwendet.

Bezahlvorgang testen

Den Bezahlvorgang können Sie im Sandbox-Modus testen. Die Sandbox ist eine eigenständige Testumgebung, welche alle Funktionen der Live-Umgebung, mit Ausnahme echter und abgelehnter Zahlungen, unterstützt. Die Testumgebung aktivieren Sie, indem Sie in Unreal Editor unter Settings > Project Settings > Plugins > Xsolla Settings > Purchases das Kontrollkästchen Enable Sandbox aktivieren (ist standardmäßig aktiviert).

1. Führen Sie Ihre Anwendung oder Ihre Map in Unreal Editor aus.
2. Wählen Sie Bankkarte als Zahlungsmethode.
3. Geben Sie die Bankkartendaten ein. In die anderen Felder (z. B. Name oder Adresse) können Sie beliebige Daten eingeben. Sie können auch falsche Angaben (Kartennummer oder Ablaufdatum) machen, um zu testen, ob ein Fehler generiert wird.
4. Klicken Sie auf Zahlen.

Liste der Testkarten

Sehen Sie sich die komplette Liste der verfügbaren Testbankkarten an.

So zeigen Sie die in der Testumgebung getätigten Transaktionen an:

1. Öffnen Sie Ihr Kundenportal.
2. Navigieren Sie zu Finanzen > Transaktionsregister.
3. Klicken Sie das Kästchen Testtransaktionen anzeigen an.