如何配置重定向

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

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

注:
可以为不同支付状态配置不同的重定向方式。

配置自动重定向

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

  • 通过发布商帐户
  • 通过API
  • 注意
    通过API传入的重定向配置优先级高于发布商帐户中的设置。

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

    1. 发布商帐户中打开您的项目,然后前往支付中心 > 设置 > 重定向策略

    1. 返回URL字段,输入用户付款后将其重定向到的URL地址或路径。
    2. 在下拉列表中,选择自动重定向条件
      • — 不发生重定向。
      • 成功 — 支付成功后发生重定向。
      • 成功或已取消 — 支付成功或取消支付后发生重定向。
      • 任何支付 — 任何支付状态都发生重定向。
    3. 延迟字段,输入以秒为单位的重定向超时时间。
    4. 单击保存

    注意
    默认情况下,重定向在0秒内激活。

    通过API配置自动重定向

    重定向配置在创建令牌端点的return_url参数和redirect_policy参数组中指定。

    1. return_url参数中,传入用户付款后将其重定向到的URL地址或路径。
    2. autoredirect_from_status_page参数设置为true
    3. delay参数中,传入以秒为单位的重定向超时时间。
    4. redirect_conditions参数中,传入激活重定向的条件:
      • none — 不发生重定向。
      • successful — 支付成功后发生重定向。
      • successful_or_canceled — 支付成功或取消支付后发生重定向。
      • any — 任何支付状态都发生重定向。

    以下GET参数自动添加到链接中:

    • user_id — 用户ID
    • foreigninvoiceexternal_id参数中传递的交易ID
    • invoice_id — 交易ID
    • status — 交易状态

    配置手动重定向

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

    注意
    通过API传入的重定向配置优先级高于发布商帐户中的设置。

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

    1. 发布商帐户中打开您的项目,然后前往支付中心 > 设置 > 重定向策略

    1. 返回URL字段,输入用户付款后将其重定向到的URL地址或路径。
    2. 在下拉列表中,选择自动重定向条件
      • — 不发生重定向。
      • 成功 — 支付成功后发生重定向。
      • 成功或已取消 — 支付成功或取消支付后发生重定向。
      • 任何支付 — 任何支付状态都发生重定向。
    3. 延迟字段留空。
    4. 手动重定向条件下拉列表中,选择显示重定向按钮的支付状态。
    5. 重定向按钮文字字段中,输入将用户重定向到返回URL的按钮文字。
    6. 单击保存

    注意

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

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

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

    通过API配置手动重定向

    重定向配置在创建令牌端点的return_url参数和redirect_policy参数组中指定。

    1. return_url参数中,传入用户付款后将其重定向到的URL地址或路径。
    2. redirect_conditions参数中,传入激活重定向的条件:
      • none — 不发生重定向。
      • successful — 支付成功后发生重定向。
      • successful_or_canceled — 支付成功或取消支付后发生重定向。
      • any — 任何支付状态都发生重定向。
    3. manual_redirection_action参数中,传入由用户点击关闭或返回按钮触发的支付UI行为:
      • redirect(默认) — 将用户重定向到返回URL。
      • postmessage — 点击关闭图标发起close-widget事件的发送,点击返回按钮发起return事件的发送。该情况下,用户不会被重定向到返回URL。您需要为关闭支付UI配置事件处理或重定向。
    4. redirect_button_caption参数中,传入将用户重定向到返回URL的按钮文字。
    5. status_for_manual_redirection参数中,传入显示重定向按钮的支付状态:
      • none — 不发生重定向。
      • successful — 支付成功后发生重定向。
      • successful_or_canceled — 支付成功或取消支付后发生重定向。
      • any — 任何支付状态都发生重定向。

    以下GET参数自动添加到链接中:

    • user_id — 用户ID
    • foreigninvoiceexternal_id参数中传递的交易ID
    • invoice_id — 交易ID
    • status — 交易状态

    注意
    如果支付UI在iframe中打开,且ui.desktop.header.close_button参数设置为true,则用户点击关闭图标时只发送postmessage事件。这样您可以处理该事件并关闭支付UI,而用户可以停留在发起支付的页面。

    重定向配置示例

    示例1

    如果在发布商帐户中为不同平台上的支付使用同一个项目进行处理,可以为在浏览器中处理的支付配置默认重定向,为移动设备上的支付配置自定义重定向。

    要配置默认重定向,请在return_url参数中传入用户付款后将其重定向到的URL地址或路径。3秒延迟的自定义自动重定向示例如下:

    Copy
    Full screen
    Small screen

      {
          "redirect_policy": {
          "redirect_conditions": "successful",
          "autoredirect_from_status_page": true,
          "delay": 3
        }
      }

      示例2

      如果在网站上销售商品且使用游戏启动器,可在发布商帐户中配置用于网站的重定向,并在令牌中自定义用于启动器的重定向配置:

      Copy
      Full screen
      Small screen

        {
          "redirect_policy": {
            "redirect_conditions": "successful_or_canceled",
            "status_for_manual_redirection": "successful_or_canceled",
            "manual_redirection_action": "postmessage"
          }
        }

        本文对您的有帮助吗?
        谢谢!
        我们还有其他可改进之处吗? 留言
        非常抱歉
        请说明为何本文没有帮助到您。 留言
        感谢您的反馈!
        我们会查看您的留言并运用它改进用户体验。
        为此页面评分
        为此页面评分
        我们还有其他可改进之处吗?

        不想回答

        感谢您的反馈!
        上次更新时间: 2023年6月5日

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

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