如何配置重定向

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

  • 自动 — 在指定延迟时间内重定向。
  • 手动 — 用户关闭支付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
    • foreigninvoice — external_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
    • foreigninvoice — external_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年10月10日

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

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