Zahlungsportal-Theme anpassen

So funktioniert's

Für das Zahlungsportal stehen standardmäßig zwei Themes zur Auswahl: hell und dunkel. Um ohne Aufruf des Editors zwischen den beiden Themes zu wechseln, übermitteln Sie 63295a9a2e47fab76f7708e1 (für das helle Theme) bzw. 63295aab2e47fab76f7708e3 (für das dunkle Theme) im Parameter settings.ui.theme beim Abruf des Token.

Um das Zahlungsportal an das Spieldesign anzupassen, können Sie ein benutzerdefiniertes Theme erstellen und die folgenden Merkmale konfigurieren:

• Farben der UI-Elemente
• Schriftgröße
• Rahmenbreite und Eckenradius der UI-Elemente
• Layout
• Anzeige eines Spiellogos

Sie können ein benutzerdefiniertes Theme als Standard-Theme für alle Ihre Projekte im Kundenportal festlegen. Wenn Sie für ein bestimmtes Spiel ein anderes Theme verwenden möchten, übermitteln Sie die entsprechenden Einstellungen im Token.

Anpassung im Kundenportal vornehmen

1. Öffnen Sie Ihr Projekt im Kundenportal, und navigieren Sie zu Pay Station > UI-Theme.

2. Klicken Sie auf Neues Theme erstellen.
3. Klicken Sie auf das Stift-Symbol, um den Namen des Themes zu ändern.

4. Wechseln Sie zur Registerkarte Farben, um die Farben der UI-Elemente zu ändern. Sie können die Farbpalette für Oberflächen, Texte und Steuerelemente sowie die Farben, die in Statusbenachrichtigungen angezeigt werden, ändern.

5. Wechseln Sie zur Registerkarte Typografie, um die Schriftgröße anzupassen. Anhand der entsprechenden Felder können Sie die Schriftgröße der folgenden UI-Elemente ändern:

6. Wechseln Sie zur Registerkarte Rahmen, um Änderungen an der Rahmenbreite und dem Eckenradius von UI-Elementen vorzunehmen.

7. Aktivieren Sie im Abschnitt Vorschau das Kontrollkästchen Logo anzeigen, um zu sehen, wie das Spielelogo im Zahlungsportal angezeigt wird. Damit das Logo im Zahlungsportal angezeigt wird, müssen Sie die nötigen Parameter im Token übermitteln.

8. Wechseln Sie im Bereich Vorschau zwischen den entsprechenden Registerkarten, um zu sehen, wie das Theme in der Desktop- bzw. der für Mobilgeräte optimierten Version des Zahlungsportals aussieht.

9. Wechseln Sie zwischen den Registerkarten Zahlung mit Karte, Zahlungsmethoden und Zahlungsstatus, um sich die verschiedenen Zahlungsportal-Zustände anzeigen zu lassen.

10. Klicken Sie auf Veröffentlichen.
11. Stellen Sie den Schalter Als Standard festlegen im sich öffnenden Modalfenster auf Ein, um dieses Theme für alle Ihre Projekte im Kundenportal zu übernehmen. Diese Einstellung hat keine Auswirkungen auf Projekte, bei denen das Theme im Token übermittelt wird.
12. Klicken Sie auf Veröffentlichen.

Wenn Sie auf der Registerkarte UI-Theme im Block eines bestimmten Themes auf ••• klicken, stehen Ihnen die folgenden Schnellaktionen zur Verfügung:

• Anpassen – öffnet den Editor, um Änderungen vorzunehmen.
• Bearbeiten – zum Ändern des Theme-Namens und zum Ein- und Ausschalten der Option Als Standard festlegen.
• Duplizieren – Dupliziert ein Theme, erstellt also ein neues basierend auf dem originalen.
• Theme löschen.

Anpassung über API konfigurieren

Layout ändern

Sie können das Layout des Zahlungsportals ändern und so das Zahlungsportal an die Oberfläche Ihres Spiels anpassen. Übermitteln Sie dazu den Parameter settings.ui.layout beim Erstellen eines Tokens. Diesem Parameter können die folgenden Werte zugewiesen werden:

• embed – in diesem Fall wird das Zahlungsportal im Spiel geöffnet, das Padding ist dabei an den Rändern beschnitten, damit es zu anderen UI-Elementen passt.

• column_reverse – in diesem Fall sind die Spalten im Zahlungsportal vertauscht: Informationen über Zahlungsmethoden werden auf der linken Seite angezeigt und Bestellinformationen auf der rechten Seite.

• embed_column_reverse – in diesem Fall wird das Zahlungsportal in Ihrem Spiel geöffnet und die Spalten im Zahlungsportal sind vertauscht: Informationen über Zahlungsmethoden werden auf der linken Seite angezeigt und Bestellinformationen auf der rechten Seite.

Die Anzeige von Zahlungsmethoden konfigurieren

Um die Anzeige von Zahlungsmethoden bei der Öffnung des Zahlungsportals zu konfigurieren, können Sie folgende Parameter in den Token einfügen:

• is_payment_methods_list_mode ermöglicht beim Öffnen des Zahlungsportals die Anzeige einer Liste von Zahlungsmethoden, die im Land des Benutzers verfügbar sind.

• settings.ui.gp_quick_payment_button ermöglicht Ihnen die Anzeige der Google Pay Zahlungsmethode im Zahlungsportal. Dieser Parameter kann folgende Werte enthalten:
  • true — in diesem Fall wird die Schaltfläche für eine schnelle Zahlung über Google Pay am Kopfende des Zahlungsportals angezeigt.

• • false (standardmäßig) — in diesem Fall wird Google Pay in der Liste der Zahlungsmethoden gemäß des Algorithmus PayRank angezeigt.

Einstellungen für das benutzerdefinierte Theme im Token übermitteln

Übermitteln Sie beim Erstellen eines Token die ID des veröffentlichten benutzerdefinierten Themes im Parameter settings.ui.theme, um die benutzerdefinierten Einstellungen für ein bestimmtes Spiel zu übernehmen.

Hier finden Sie die Theme-ID:

• In der Liste aller Themes auf der Registerkarte UI-Theme.

• Im Editor unter dem Theme-Namen.

Spiellogo anzeigen

So zeigen Sie das Spiellogo im Zahlungsportal an:

1. Öffnen Sie Ihr Projekt im Kundenportal, und laden Sie ein Bild unter Pay Station > Einstellungen hoch.

2. Übermitteln Sie bei der Anfrage, einen Token zu erstellen, den Wert true in den beiden Parametern settings.ui.desktop.header.is_visible und settings.ui.desktop.header.visible_logo. Je nach Ihrem Integrationsszenario können Sie die serverseitige oder die clientseitige Methode zur Erstellung eines Tokens aufrufen.

Anzeige eines Spiellogos im Zahlungsportal (Beispiel):

Letztmalig aktualisiert: 2. April 2025