一般信息

支付UI基于支付中心产品。可用支付方式的选择以及其他设置在发布商帐户支付中心部分提供。

SDK支持一键购买或通过购物车购买目录中的商品。

要测试购买过程,可使用支付UI的沙盒模式和测试银行卡进行。沙盒模式只模拟支付方式的行为,不涉及真实支付。使用沙盒模式无需与艾克索拉签署任何协议或支付任何费用。

注意
首次完成真实付款后,严格沙盒付款政策即生效。在沙盒模式下进行支付仅适用于发布商帐户公司设置 > 用户部分中指定的用户。

详解

通过方法详解文档了解高级设置。

如何设置在用户支付后重定向到应用程序

要在用户完成支付后将其重定向到其他页面,有两种重定向方式可以配置:

  • 自动 — 根据指定延迟时间重定向。
  • 手动 — 用户关闭支付UI或点击重定向按钮后发生重定向。

您可以通过以下方式配置重定向:

  • 在发布商帐户中配置 — 如果您是一个应用程序设置一个项目且不打算为不同平台创建不同编译版本,请使用此方式。

  • 在SDK设置中配置 — 如打算进行以下操作,请使用此方式:
    • 为多个应用程序使用同一个项目
    • 为不同平台创建不同编译版本
    • 通过网站销售游戏内商品
注意
如果发布商帐户中和SDK设置中都配置了重定向,则使用SDK设置中指定的参数。

在发布商帐户中配置重定向

  1. 发布商帐户中打开您的项目。
  2. 在侧边栏中单击支付中心
  3. 前往设置 > 重定向政策部分。
  1. 返回URL字段中,输入用户支付后将其重定向到的URL或路径。
注:
要将用户重定向到一个移动应用程序,URL必须符合以下机制之一:

  1. 要设置自动重定向参数:
    1. 在下拉菜单列表中,选择自动重定向条件
      • 无 — 不重定向
      • 成功支付 — 支付成功后发生重定向。
      • 成功或已取消 — 支付成功或取消支付后发生重定向。
      • 任何支付 — 任何支付状态都发生重定向。
    2. 延迟字段,输入以秒为单位的重定向超时时间。默认情况下,重定向在被激活后0秒发生。

  1. 要设置手动重定向参数:
    1. 在下拉菜单列表中,选择手动重定向条件
      • 无 — 不重定向
      • 成功支付 — 支付成功后显示重定向按钮。
      • 成功或已取消 — 支付成功或取消支付后显示重定向按钮。
      • 任何支付 — 任何支付状态都显示重定向按钮。
    2. 重定向按钮文字字段,输入将用户重定向到返回URL的按钮文字。
注意

重定向按钮的默认文字是返回游戏。该文字已翻译为所有支付中心语言。

如果您的项目项目支持多个语言,您可以在相应字段中为每个语言指定重定向按钮文字。

用户关闭支付UI后,他们也将被重定向到指定的返回URL。

  1. 单击保存

在SDK设置中配置重定向

将重定向参数传入init方法。方法是按照下面Android编译版本的示例在Cocos Creator中的项目源代码中添加相应代码行。设置以下重定向参数:

  1. useSettingsFromPublisherAccount中传入false
  2. returnUrl中,传入用户支付后将其重定向到的URL或路径。
注:
要将用户重定向到一个移动应用程序,URL必须符合以下机制之一:

  1. 要设置自动重定向参数:
    1. redirectCondition参数中,传入激活重定向的条件:
      • PaymentRedirectCondition.none — 不重定向。
      • PaymentRedirectCondition.successful — 支付成功时重定向。
      • PaymentRedirectCondition.successful_or_canceled — 支付成功或被取消时重定向。
      • PaymentRedirectCondition.any — 任何支付状态都重定向。
    2. redirectDelay参数中,传入重定向超时时间,单位为秒。

  1. 要设置手动重定向参数:
    1. redirectStatusManual参数中,传入显示重定向按钮的支付状态:
      • PaymentRedirectCondition.none — 不重定向。
      • PaymentRedirectCondition.successful — 支付成功时重定向。
      • PaymentRedirectCondition.successful_or_canceled — 支付成功或被取消时重定向。
      • PaymentRedirectCondition.any — 任何支付状态都重定向。
    2. redirectButtonCaption参数中,传入将用户重定向到返回URL的按钮文本。
注意

重定向按钮的默认文字是返回游戏。该文字已翻译为所有支付中心语言。

如果您的项目项目支持多个语言,您可以在相应字段中为每个语言指定重定向按钮文字。

用户关闭支付UI后,他们也将被重定向到指定的返回URL。

Android编译版本的重定向设置示例:

Copy
Full screen
Small screen
let redirectPolicySettingsAndroid: RedirectPolicySettings = {
                useSettingsFromPublisherAccount: false,
                returnUrl: 'app://xpayment.com.example.myapp',
                redirectCondition: PaymentRedirectCondition.successful,
                redirectDelay: 0,
                redirectStatusManual: PaymentRedirectStatusManual.successful,
                redirectButtonCaption: 'Back to the game'
        };
var settings: XsollaSettings = {
            loginId: '<yourLoginId>',
            projectId: '<yourProjectId>',
            clientId: '<yourClientId>',
            enableSandbox: IsSandbox,
            redirectPolicySettingsAndroid: redirectPolicySettingsAndroid
        }

        Xsolla.init(settings);
注:
您可以针对不同的编译版本平台为您的应用程序设置不同的重定向参数。方法是使用以下参数:
  • redirectPolicySettingsAndroid
  • redirectPolicySettingsIOS
  • redirectPolicySettingsWebGL
本文对您的有帮助吗?
谢谢!
我们还有其他可改进之处吗? 留言
非常抱歉
请说明为何本文没有帮助到您。 留言
感谢您的反馈!
我们会查看您的留言并运用它改进用户体验。
隐藏

继续阅读

上次更新时间: 2024年3月6日

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

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