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

Zum Öffnen des Zahlungsportals benötigen Sie einen Token. Ein Token ist ein String, der verschlüsselte Daten über ein Spiel und einen Benutzer enthält. Sie müssen den Abruf eines Tokens implementieren, um den Benutzer zu identifizieren und den Kauf zu ermöglichen.

Implementieren Sie im Backend Ihrer Anwendung den Abruf eines Benutzerauthentifizierungstokens. Nutzen Sie dafür eine HTTP-POST-Anfrage mit HTTP-Basisauthentifizierung, und übermitteln Sie die erforderlichen Parameter im Anfragerumpf.

API-Referenz

Sehen Sie sich die komplette Liste der Parameter an.

Der Token verfällt 14 Stunden nach dem letzten Aufruf der Xsolla-API. Implementieren Sie die Logik für den Erhalt eines neuen Tokens nach dessen Verfall. Es wird empfohlen, einen neuen Token im Hintergrund abzurufen, damit sich der Benutzer nicht erneut bei der Anwendung anmelden muss.

HTTP-Basisauthentifizierung

Die Xsolla-API nutzt die Basisauthentifizierung. Alle Anfragen an die API müssen den Header Authorization: Basic <your_authorization_basic_key> enthalten, wobei <your_authorization_basic_key> das gemäß dem Base64-Standard kodierte Paar Händler-ID:API-Schlüssel ist. Die Parameter finden Sie im Kundenportal:

• Die Händler-ID finden Sie:
  • unter Projekteinstellungen > Webhooks.
  • unter Firmeneinstellungen > Firma.
  • in der URL in der Adresszeile des Browsers auf einer beliebigen Seite im Kundenportal. Die URL weist das folgende Format auf: https://publisher.xsolla.com/​Händler-ID/Kundeportalabschnitt.

• Der API-Schlüssel wird im Kundenportal nur einmal angezeigt, nämlich dann, wenn er erstellt wird. Sie sind selbst dafür verantwortlich, den Schlüssel zu speichern. Einen neuen Schlüssel können Sie in den folgenden Abschnitten erstellen:
  • Firmeneinstellungen > API-Schlüssel
  • Projekteinstellungen > API-Schlüssel

Anfragerumpf

Übermitteln Sie im Anfragerumpf die folgenden erforderlichen Parameter:

Um das Benutzererlebnis weiter zu verbessern, können Sie auch die folgenden Parameter übermitteln:

Beispiel: Anfrage eines Benutzerauthentifizierungstokens

curl -i -X POST \
  -u 2340:ZHgbSDVP6LtAJVWu \
  https://api.xsolla.com/merchant/v2/merchants/<merchant_id>/token \
  -H 'Content-Type: application/json' \
  -d '{
    "settings": {
      "currency": "USD",
      "language": "en",
      "project_id": <project_id>,
      "ui": {
        "size": "medium"
      }
    },
    "user": {
      "email": {
        "value": "<user_email>"
      },
      "id": {
        "value": "<user_id>"
      },
      "name": {
        "value": "<user_name>"
      }
    }
  }'

Beispiel: Antwort mit Benutzerauthentifizierungstoken

{
    "token": "1230OWrp0KF6uqvmN8jWuzLyoXMzxTyK_lc_en"
}

Zahlungsportal öffnen

Neues Fenster

Um die Benutzeroberfläche in einem neuen Fenster zu öffnen, nutzen Sie die folgende URL: https://sandbox-secure.xsolla.com/paystation4/?access_token=TOKEN, wobei TOKEN der erhaltene Token ist.

Das Zahlungsportal lässt sich auch auf andere Wege öffnen:

• Mit Pay Station Embed. Einschränkung: beim Öffnen im Ingame-Browser (WebView) kann es zu Problemen kommen.
• in einem iframe. Einschränkung: beim Öffnen im Ingame-Browser (WebView) und in Ihrer mobilen App kann es zu Problemen kommen.

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 initialisieren möchten, verwenden Sie den folgenden Link: https://secure.xsolla.com/paystation4/?access_token=TOKEN.

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

Iframe

So öffnen Sie das Testumgebung in einem iframe:

1. Implementieren Sie den postMessage-Mechanismus, um Zahlungsportal-Ereignisse empfangen zu können.
2. Öffnen Sie das Zahlungsportal über den folgenden Link: https://sandbox-secure.xsolla.com/paystation4/?access_token=TOKEN, wobei TOKEN der erhaltene Token ist.

Webhooks einrichten

Wenn Sie über Ereignisse (z. B. Änderung des Zahlungsstatus) benachrichtigt werden möchten, müssen Sie Webhooks im Kundenportal einrichten:

1. Öffnen Sie Ihr Projekt im Kundenportal.
2. Klicken Sie in der Seitenleiste auf Projekteinstellungen, und wechseln Sie zur Registerkarte Webhooks.
3. Stellen Sie den Schalter Webhooks auf Ein.
4. Geben Sie die Webhook-URL an.
5. Daraufhin wird standardmäßig ein geheimer Schlüssel zum Signieren der Projekt-Webhooks generiert. Wenn Sie einen neuen geheimen Schlüssel generieren möchten, klicken Sie auf das Aktualisieren-Symbol.
6. Klicken Sie auf Einstellungen speichern.

Es wird empfohlen, die folgenden Webhooks zu implementieren:

• Benutzervalidierung
• Zahlung
• Abrufen des Warenkorbinhalts beim Kauf
• Erstattung
• Teilerstattung

Um den Empfang des Webhooks zu bestätigen, muss Ihr Server wie folgt antworten:

• HTTP-Statuscode 204 ohne Nachrichtenrumpf.
• HTTP-Statuscode 400 samt Problembeschreibung, sofern der angegebene Benutzer nicht gefunden oder eine ungültige Signatur übermittelt wurde.

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

PayPal-Testkonto erstellen

Sie müssen ein Konto im PayPal-Sandboxmodus erstellen, um den Zahlungsvorgang zu testen:

1. Öffnen Sie die PayPal Developer-Website.
2. Melden Sie sich bei Ihrem Konto an oder erstellen Sie ein neues.
3. Wechseln Sie zur Registerkarte Sandbox accounts.
4. Klicken Sie auf der Seite Sandbox test accounts auf Create account.
5. Wählen Sie Personal (Buyer Account) als Kontotyp aus, und wählen Sie ein Land.
6. Klicken Sie auf Create.

Das erstellte Konto wird in der Liste der Sandbox Accounts angezeigt.

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

Testzahlung durchführen

1. Öffnen Sie das Zahlungsportal in der Testumgebung.
2. Wählen Sie PayPal als Zahlungsmethode aus.
3. Geben Sie im Feld Mock Response Code den Wert 0 ein oder lassen Sie das Feld leer.
4. Geben Sie im Feld Postleitzahl fünf beliebige Ziffern ein.

5. Klicken Sie auf Zahlen. Daraufhin werden Sie zu einem Fenster weitergeleitet, melden Sie sich dort bei Ihrem PayPal-Konto an.
6. Geben Sie Informationen zu Ihrem Sandbox Account ein: Email ID (E-Mail-Adresse) und System Generated Password (Passwort). Die entsprechenden Informationen finden Sie hier:
   1. Melden Sie sich auf der PayPal Developer-Website bei Ihrem Konto an.
   2. Wechseln Sie zur Registerkarte Sandbox accounts.
   3. Wählen Sie auf der Seite Sandbox test accounts ein Sandbox Account.
   4. Klicken Sie auf •••, und wählen Sie in der Drop-down-Liste den Eintrag View/Edit account. Daraufhin öffnet sich ein Modalfenster mit den entsprechenden Daten.
7. Schließen Sie die Testzahlung ab.

Live schalten

Nachdem Sie die vorangegangenen Schritte durchgeführt haben, können Sie echte Zahlungen entgegennehmen:

1. Stellen Sie sicher, dass Sie die Xsolla-Lizenzvereinbarung unterzeichnet haben.
2. Entfernen Sie den Parameter "sandbox": true aus dem Anfragerumpf, wenn Sie einen Token abrufen.
3. Öffnen Sie das Zahlungsportal über den folgenden Link: https://secure.xsolla.com/paystation4/?access_token=TOKEN.