Customisation du thème de l’interface de paiement

Comment ça marche

Par défaut, deux thèmes sont disponibles pour l’interface de paiement : clair et foncé. Pour basculer d’un thème à l’autre sans utiliser le customiseur, passez 63295a9a2e47fab76f7708e1 pour le thème clair ou 63295aab2e47fab76f7708e3 pour le thème foncé dans le paramètre settings.ui.theme lors de l’obtention du jeton.

Pour adapter l’interface de paiement au design du jeu, créez un thème customisé et configurez les caractéristiques suivantes :

Vous pouvez utiliser un thème customisé comme thème par défaut pour tous les projets de votre Compte éditeur. Si vous souhaitez spécifier différents thèmes pour des jeux individuels, passez ces paramètres dans le jeton.

Avis
Les configurations de thème passées dans le jeton ont la priorité sur les configurations spécifiées dans le Compte éditeur.
Note
Pour le bon affichage du logo et des boutons Xsolla lors du choix d’un mode de paiement, reportez-vous aux lignes directrices.

Configurer la customisation dans le Compte éditeur

Note
Vous pouvez créer un thème customisé dans un projet et l’utiliser dans tous les projets de votre Compte éditeur.
  1. Ouvrez le projet dans votre Compte éditeur et accédez à la section Pay Station > UI theme.
  1. Cliquez sur Create new theme.
  2. Cliquez sur l'icône en forme de crayon pour modifier le nom du thème.
  1. Pour modifier les couleurs des éléments de l'interface, accédez à l'onglet Colors. Vous pouvez ajuster la palette de couleurs des surfaces, des textes et des éléments de contrôle, ainsi que les couleurs qui apparaissent dans les notifications d'état.
  1. Pour définir la taille de la police, accédez à l'onglet Typography. Utilisez les champs correspondants pour modifier la taille de la police des éléments suivants de l'interface :
ChampÉlément d’interface
Title 1Titre de la page d’état du paiement.
Title 2Valeur du montant total.
Title 3En-têtes de sections (par exemple, Paiement par carte).
Title 4Non utilisé actuellement.
Body L
  • en-têtes de sous-sections ;
  • en-têtes dans les instructions pour le paiement en espèces ;
  • texte de boutons ;
  • mention Total.
Body M
  • nom du projet (il est affiché lorsqu’il n’y a pas de logo de projet) ;
  • texte dans les infobulles et les descriptions ;
  • message sur la page d’état du paiement ;
  • texte dans la liste des modes de paiement (liste déroulante dans la version mobile).
Minor text
  • nom d’utilisateur ;
  • mention légale ;
  • informations figurant dans le panier (par exemple, le nom de l’objet, le montant de la TVA).
HeadingNon utilisé actuellement.
  1. Pour configurer la largeur de la bordure et le rayon des angles des éléments de l'interface, accédez à l'onglet Borders et apportez les modifications nécessaires.
Note
Largeur maximale de la bordure : 3 px.
Rayon d’angle maximal : 16 px.
  1. Pour visualiser l'apparence du logo du jeu dans l'interface de paiement, cochez la case Show logo dans la section Preview. Pour configurer l'affichage du logo du jeu dans l'interface de paiement, passez les paramètres nécessaires dans le jeton.
  1. Pour visualiser l'apparence d'un thème sur les versions mobile et de bureau de l'interface de paiement, basculez entre les onglets dans la section Preview.
Avis
Les boutons et les liens ne fonctionnent pas en mode aperçu.
  1. Pour visualiser les différents états de l'interface de paiement, basculez entre les onglets Payment by card, Payment methods et Payment status.
  1. Cliquez sur Publish.
  2. Une fenêtre modale s'ouvre. Pour appliquer ce thème à tous les projets de votre compte éditeur, réglez la bascule Set as default sur On. Cela n'affectera pas les projets pour lesquels le thème est passé dans le jeton.
  3. Cliquez sur Publish.
Avis
Une fois le thème publié, vous avez la possibilité de le modifier à tout moment. Cependant, notez que le thème n’est pas appliqué à l’interface de paiement tant que vous ne l’aurez pas défini comme thème par défaut ou activé à l’aide des paramètres du jeton.
Dans l’onglet UI theme, lorsque vous cliquez sur ••• dans le bloc d’un thème particulier, vous avez accès aux actions rapides suivantes :
  • Customize — ouvre le customiseur pour apporter des modifications ;
  • Edit — permet de modifier le nom du thème et de définir l’option Set as default sur On ou Off ;
  • Duplicate — permet de dupliquer un thème pour créer un nouveau à base de celui-ci ;
  • Delete — supprime le thème.

Configurer la customisation via API

Modifier la disposition

Pour adapter l’interface de paiement à l’interface de votre jeu, vous pouvez modifier la disposition de l’interface de paiement. Pour ce faire, passez le paramètre settings.ui.layout lors de la création d’un jeton. Ce paramètre peut prendre les valeurs suivantes :
  • embed — dans ce cas, l’interface de paiement s’ouvre dans votre jeu : les marges intérieures de l’interface de paiement sont découpées sur les bords pour s’adapter aux autres éléments de l’interface.
  • column_reverse — dans ce cas, l'ordre des colonnes de l'interface de paiement change : les informations sur les modes de paiement s'affichent sur le côté gauche et les informations sur la commande sur le côté droit.
  • embed_column_reverse — dans ce cas, l'interface de paiement s'ouvre dans votre jeu et l'ordre des colonnes de l'interface de paiement change : les informations sur les modes de paiement s'affichent sur le côté gauche et les informations sur la commande sur le côté droit.

Configurer l'affichage des modes de paiement

Pour configurer l’affichage des modes de paiement à l’ouverture de l’interface de paiement, passez les paramètres suivants dans le jeton :
  • is_payment_methods_list_mode permet d’affiche la liste des modes de paiement disponibles dans le pays de l’utilisateur dès l’ouverture de l’interface de paiement.
  • settings.ui.gp_quick_payment_button permet de configurer l'affichage du mode de paiement Google Pay dans l'interface de paiement. Ce paramètre peut accepte les valeurs suivantes :
    • true — dans ce cas, le bouton de paiement rapide via Google Pay s'affiche en haut de l'interface de paiement ;
    • false (par défaut) — dans ce cas, Google Pay s'affiche dans la liste des modes de paiement selon l' algorithme PayRank.

Passer les paramètres du thème customisé dans un jeton

Pour appliquer des paramètres customisés à un jeu spécifique, passez l’ID du thème customisé publié dans le paramètre settings.ui.theme lors de la création du jeton.

Vous trouverez l’ID du thème :

  • Dans la liste de tous les thèmes sous l’onglet UI theme.

  • Dans le customiseur, sous le nom du thème.
Avis
Les configurations de thème passées dans le jeton ont la priorité sur les configurations spécifiées dans le Compte éditeur.

Pour afficher le logo de votre jeu dans l’interface de paiement :

  1. Ouvrez le Compte éditeur et téléchargez une image sous la section Pay Station > Settings.

Note
Taille de fichier maximale : 1 Mo.
Formats pris en charge : JPEG, PNG, SVG.

  1. Dans la requête de création du jeton, passez true dans les paramètres settings.ui.desktop.header.is_visible et settings.ui.desktop.header.visible_logo. En fonction de votre scénario d'intégration, appelez la méthodecôté serveur ou côté client pour créer un jeton.

Exemple d’affichage du logo d’un jeu dans l’interface de paiement :

Cet article vous a été utile ?
Merci !
Que pouvons-nous améliorer ? Message
Nous sommes désolés de l'apprendre
Dites-nous pourquoi vous n'avez pas trouvé cet article utile. Message
Merci pour votre commentaire !
Nous examinerons votre message et l'utiliserons pour améliorer votre expérience.
Dernière mise à jour: 3 Octobre 2024

Faute de frappe ou autre erreur dans le texte ? Sélectionnez le texte concerné et appuyez sur Ctrl+Entée.

Signaler un problème
Nous améliorons continuellement notre contenu grâce à vos commentaires.
Indiquez votre adresse e-mail pour un suivi
Merci pour votre commentaire !