自定义支付UI主题

运行机制

支付UI有两个默认主题可用：浅色和深色。如要在不使用定制器情况下在主题间切换，请在获取令牌时在settings.ui.theme参数中传入63295a9a2e47fab76f7708e1使用浅色主题或传入63295aab2e47fab76f7708e3使用深色主题。

要让支付UI与游戏设计相匹配，可创建自定义主题并配置以下特性：

您可以将自定义主题用作您发布商帐户中所有项目的默认主题。如要为单个游戏指定其他主题，请在令牌中传入相关设置。

注意
在令牌中传递的主题配置优先级高于在发布商帐户中指定的配置。
注：
为确保在选择支付方式时正确显示艾克索拉Logo和按钮，请参阅指南。

在发布商帐户中配置自定义

注：
您可以在一个项目中创建自定义主题，然后在发布商帐户中为所有项目使用该主题。
  1. 在发布商帐户中打开您的项目，然后前往支付中心 > UI主题部分。
  1. 单击创建新主题。
  2. 单击铅笔图标更改主题名称。
  1. 要更改UI元素的颜色，请前往颜色选项卡。您可以更改平面、文字、控件以及状态通知中显示的颜色。
  1. 要设置字体大小，请前往版式选项卡。请使用相应字段更改以下UI元素的字体大小：
字段UI元素
Title 1支付状态页面上的标题。
Title 2总金额值。
Title 3版块标题（如用银行卡支付）。
Title 4当前未使用。
正文L
  • 子版块标题
  • 现金支付说明中的标题
  • 按钮文字
  • 总计文字
正文M
  • 项目名称（没有项目Logo时显示）
  • 提示和描述中的文字
  • 支付状态页面上的消息
  • 支付方式列表中的文字（移动版本中的下拉列表）
副文本
  • 用户名
  • 法律信息文本
  • 购物车中的信息（如商品名、增值税金额）
小标题当前未使用。
  1. 要配置UI元素的边框宽度和圆角度，请前往边框选项卡并进行更改。
注：
最大边框宽度 — 3 px。
最大圆角度 — 16 px。
  1. 要查看游戏Logo在支付UI中的显示效果，请在预览部分勾选显示Logo复选框。要设置游戏Logo在支付UI中的显示，请在令牌中传入必要参数。
  1. 要查看主题在移动版和桌面版支付UI上的效果，请在预览部分的相应选项卡间切换。
注意
预览模式下的按钮和链接不起实际作用。
  1. 要查看支付UI的不同状态，请在银行卡支付、支付方式和支付状态选项卡间切换。
  1. 单击发布。
  2. 要对发布商帐户中的所有项目应用该主题，请在打开的模态窗口中将设置为默认开关设置为开。此操作不会影响在令牌中传入主题的项目。
  3. 单击发布。
注意
主题发布后您可以随时对它进行编辑。在未将主题设置为默认主题或通过令牌设置启用的情况下，主题不会应用于支付UI。
在UI主题选项卡中，在某个主题区块单击•••可使用以下快捷操作：
  • 自定义 — 打开定制器进行更改。
  • 编辑 — 更改主题名称及将设置为默认开关设置为开或关。
  • 复制 — 复制一个主题以基于它创建新主题。
  • 删除主题。

通过API配置自定义

更改布局

您可以更改支付UI的布局使其与游戏界面适应。方法是，创建令牌时传入settings.ui.layout参数。该参数的值可以如下：
  • embed — 此情况下，支付UI在游戏内部打开：支付UI边缘可能被截断以适应其他界面元素。
  • column_reverse — 此情况下，支付UI中的列顺序发生改变：关于支付方式的信息在左侧显示，订单的信息在右侧显示。
  • embed_column_reverse — 此情况下，支付UI在游戏内部打开且支付UI中的列顺序发生改变：关于支付方式的信息在左侧显示，订单的信息在右侧显示。

配置支付方式的显示

要配置打开支付UI时支付方式如何显示，可在令牌中传入以下参数：
  • settings.ui.gp_quick_payment_button可以配置在支付UI中显示Google Pay支付方式。此参数支持以下值：
    • true — 此情况下，通过Google Pay快速支付的按钮在支付UI最上面显示。
    • false（默认）— 此情况下，Google Pay根据PayRank算法的结果在支付方式列表中显示。

在令牌中传入自定义UI主题设置

要对某一个游戏应用自定义设置，请在创建令牌时在settings.ui.theme参数中传入所需的已发布自定义主题的ID。

可在此处找到主题ID：

  • UI主题选项卡的全部主题列表中。

  • 定制器中的主题名称下面。
注意
在令牌中传递的主题配置优先级高于在发布商帐户中指定的配置。

要在支付UI中显示游戏的Logo：

  1. 在发布商帐户中打开您的项目，然后在支付中心 > 设置部分上传图片。

注：
最大文件大小：1 MB。
支持的格式：JPEG、PNG、SVG。

  1. 在创建令牌请求中，在settings.ui.desktop.header.is_visible和settings.ui.desktop.header.visible_logo参数中传入true。根据具体集成场景，您可以调用服务器侧或客户端侧方法来创建令牌。

在支付UI中显示游戏Logo的示例：

本文对您的有帮助吗？
谢谢！
我们还有其他可改进之处吗？ 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈！
我们会查看您的留言并运用它改进用户体验。
上次更新时间: 2024年10月3日

发现了错别字或其他内容错误？ 请选择文本，然后按Ctrl+Enter。

报告问题
我们非常重视内容质量。您的反馈将帮助我们做得更好。
请留下邮箱以便我们后续跟进
感谢您的反馈！