Zahlungslösung integrieren

Damit Sie Referrals tracken und Auszahlungen an Kooperationspartner vornehmen können, müssen Sie zuerst die Xsolla-Bezahlstation integrieren. Anforderungen:

1. Die Bezahlstation ist auf einer leistungsoptimierten Landing-Page integriert.
2. Die Bezahlstation ist die einzige Zahlungsmethode auf der Landing-Page, die den Traffic durch das Partnernetzwerk-Prorgramms leitet.

Token abrufen

Für die Integration des Zahlungsportals müssen Sie einen Token abrufen. Ein Zugriffstoken ist ein String, mit dem sich Spiele-, Benutzer- und Kaufparameter identifizieren lassen.

Xsolla-API nutzt Basisauthentifizierung. Geben Sie Ihre Händler-ID als Benutzernamen und den API-Schlüssel als Passwort an.

So finden Sie diese Daten:

1. Wechseln Sie im Kundenportal in die Firmeneinstellungen.
2. Kopieren Sie auf der Registerkarte Firma die Händler-ID.
3. Kopieren Sie auf der Registerkarte API-Schlüssel den API-Schlüssel.

URL zum Abrufen des Tokens:

https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token

Sie können die HTTP-POST-Anfrage ändern, indem Sie die Parameter einfügen, die Sie an die Zahlungsportal übermitteln möchten. Benutzerinformationen übermitteln Sie in den Parametern user.id, user.name und user.email der Token erstellen-Methode.

Hinweis

Nutzen Sie für den Parameter user.id eine Kennung, die sich leicht merken lässt, damit Benutzer sie außerhalb des Spiels (z. B. beim Aufladen des Spielguthabens mittels Push-Zahlungen) verwenden können.

API-Referenz

Sehen Sie sich die komplette Liste der Parameter an.

Sowohl die Anfrage als auch die Antwort erfolgen im JSON-Format.

Nachstehend finden Sie einen Beispielcode für das Anfordern des Tokens in PHP. Falls Sie eine andere Programmiersprache verwenden, sehen Sie sich das CURL-Beispiel an, indem Sie auf die Registerkarte CURL klicken.

<?php

$uri = 'https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token';

$body = [
    "user" => [
        "id" => [
            "value" => "1234567"
        ],
        "email" => [
            "value" => "email@example.com"
        ]
    ],
    "settings" => [
        "project_id" => 14004,
        "mode" => "sandbox"
    ],
    "purchase" => [
        "checkout" => [
            "amount" => 9.99,
            "currency" => "USD"
        ]
    ]
];

$auth = base64_encode('your_merchant_id:your_merchant_api_key');

$headers = [
    'Authorization: Basic ' . $auth,
    'Content-Type: application/json',
    'Accept: application/json',
];

$request = curl_init($uri);
curl_setopt($request, CURLOPT_RETURNTRANSFER, true);
curl_setopt($request, CURLOPT_POST, true);
curl_setopt($request, CURLOPT_POSTFIELDS, $body);
curl_setopt($request, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($request);
print_r($response);

curl -v https://api.xsolla.com/merchant/v2/merchants/{merchant_id}/token \
-X POST \
-u your_merchant_id:merchant_api_key \
-H 'Content-Type:application/json' \
-H 'Accept: application/json' \
-d '
{
    "user": {
        "id": {
            "value": "1234567"
        },
        "email": {
            "value": "email@example.com"
        }
    },
    "settings": {
        "project_id": 14004,
        "mode": "sandbox"
    },
    "purchase": {
            "checkout": {
                "amount": 9.99,
                "currency": "USD"
            }
    }
}'

Zahlungsportal öffnen

Es gibt drei Möglichkeiten, das Zahlungsportal zu öffnen:

• Pay Station Embed-Skript
• Iframe
• Neues Fenster

Pay Station Embed

BEISPIEL: ASYNCHRONES LADEN VON SCRIPTEN

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

Pay Station Embed ermöglicht das Abrufen von Ereignissen aus dem Zahlungsportal via postMessage. Diese Ereignisse können an Analytics-Systeme übermittelt werden. Wenden Sie sich zum Einrichten der Ereignisverarbeitung in Ihrem Analytics-System an Ihren Account Manager oder senden Sie eine E-Mail an am@xsolla.com.

Das Xsolla-Team hat ein Widget entwickelt, mit dem Sie das Zahlungsportal ganz einfach in Ihre Website integrieren können. Das Widget-Skript ist in unserem GitHub-Repository verfügbar.

Script-Initialisierungsparameter:

Das Script ermöglicht Ihnen, die Ereignisse im Zahlungsportal zu verfolgen. Je nach Art des Ereignisses können Sie verschiedene Aktionen auf der Website ausführen.

Liste der Ereignisse:

Wenn Sie den Ladevorgang für das Zahlungsportal selbst initialisieren möchten, verwenden Sie folgenden Link: https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN.

Für Testzwecke steht Ihnen folgende URL zur Verfügung: https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN.

Iframe

Sie müssen Ihrerseits folgende Mechanismen implementieren:

• Prüfung des Gerätetyps (Desktop oder mobiles Endgerät) und Übermittlung innerhalb des settings.ui.version-Tokenparameters.
• Abrufen von Ereignissen aus dem Zahlungsportal via postMessage. Diese Ereignisse können an Analytics-Systeme gesendet werden. Um die Verarbeitung von Ereignissen in Ihrem Analytics-System einzurichten, wenden Sie sich an Ihren Account Manager oder senden Sie eine E-Mail an am@xsolla.com.

Nutzen Sie folgenden Link, um das Zahlungsportal in einem iframe aufzurufen: https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN; wobei ACCESS_TOKEN der Token ist, der im vorherigen Schritt bezogen wurde. Für Testzwecke steht Ihnen folgende URL zur Verfügung: https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN.

Neues Fenster

Nutzen Sie folgenden Link, um das Zahlungsportal in einem neuen Fenster aufzurufen: https://secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN; wobei ACCESS_TOKEN der Token ist, der im vorherigen Schritt bezogen wurde. Für Testzwecke steht Ihnen folgende URL zur Verfügung: https://sandbox-secure.xsolla.com/paystation3/?access_token=ACCESS_TOKEN.

Webhooks einrichten

Folgende Webhooks müssen für die Bezahlstation implementiert werden:

• Benutzervalidierung
• Zahlung
• Erstattung

Was sind Webhooks

Erfahren Sie mehr über Webhooks, deren Funktionsweise und deren Einsatzzweck.

Bestätigen Sie den Erhalt eines Webhooks, indem Sie mit dem HTTP-Statuscode 204 ohne Nachrichtenrumpf antworten.

Gehen Sie zum Testen des Webhook-Handlers zum Abschnitt Projekteinstellungen > Webhooks.

Zahlungsvorgang testen

Um den Zahlungsprozess auszuprobieren, können Sie den Sandbox-Modus verwenden. Die Sandbox ist eine eigenständige Testumgebung, welche alle Funktionen der Live-Umgebung, mit Ausnahme echter und abgelehnter Zahlungen, unterstützt. Sie können auf die Testumgebung zugreifen, indem Sie "mode":"sandbox" beim Abrufen des Tokens senden.

In der Testumgebung können Sie den Zahlungsvorgang wie folgt testen:

• mit einer Bankkarte
• mit PayPal

Bankkartenzahlung testen

1. Rufen Sie das Zahlungsportal in der Testumgebung auf.
2. Wählen Sie unter Zahlungsarten die Gruppe Kredit-/Debitkarten aus.
3. Geben Sie die Bankkartendaten ein. Geben Sie alle Werte in die verbleibenden Felder ein. Sie können auch falsche Angaben (Kartennummer oder Ablaufdatum) machen, um einen Fehler zu generieren.
4. Klicken Sie auf Jetzt zahlen.

Liste der Testkarten

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

PayPal-Zahlung testen

1. Erstellen Sie ein Konto für die PayPal-Sandbox:
   1. Öffnen Sie die PayPal Developer-Website.
   2. Melden Sie sich bei Ihrem Konto an oder erstellen Sie ein neues.
   3. Navigieren Sie zu Sandbox > Accounts.
   4. Klicken Sie im Abschnitt Sandbox Account auf Create account.
   5. Wählen Sie im Modalfenster Personal als Kontotyp sowie ein Land aus.
   6. Klicken Sie auf Create. Das erstellte Konto wird in der Liste der Sandbox-Konten angezeigt.

2. Öffnen Sie das Zahlungsportal in der Testumgebung.
3. Wählen Sie PayPal als Zahlungsmethode aus.
4. Geben Sie im Zahlungsfenster die erforderlichen Informationen ein.
5. Klicken Sie auf Pay Now. Daraufhin öffnet sich ein Fenster, in dem Sie sich bei Ihrem PayPal-Konto anmelden müssen.

6. Um den Zahlungsvorgangstest abzuschließen, geben Sie die Informationen zu dem in Schritt 1 erstellten Sandbox-Konto an: Unter Email ID eine E-Mail-Adresse und unter System Generated Password ein Passwort. So finden Sie diese Informationen:
   1. Melden Sie sich bei Ihrem Konto auf der PayPal Developer-Website an.
   2. Navigieren Sie zu Sandbox > Accounts.
   3. Wählen Sie im Abschnitt Sandbox Account das Sandbox-Konto aus.
   4. Klicken Sie auf ••• und dann in der Drop-down-Liste auf View/edit account.
7. Klicken Sie auf Pay Now.

Ebenso können Sie die Informationen von bestehenden Sandbox-Konten verwenden:

Live schalten

So beginnen Sie mit der Abwicklung echter Zahlungen:

1. Stellen Sie sicher, dass Sie einen Vertrag mit Xsolla geschlossen haben.
2. Öffnen Sie die Bezahlstation über folgenden Link: secure.xsolla.com. Oder ändern Sie im Pay Station Embed-Skript die URL von sandbox-secure.xsolla.com in secure.xsolla.com.
3. Entfernen Sie "mode":"sandbox" beim Abrufen des Tokens.