PG 付款

PG支付可以在PC和移动设备上使用。

PG支付政策¶

PG支付流程¶

① 在游戏内商店选择要购买的产品

② 在游戏屏幕外的网页视图中显示支付方式选择屏幕

• 语言：游戏语言
• 货币：SDK交付的hive_country。如果没有，则通过IP检查国家并显示为该国的货币
• 支付的产品名称显示在控制台 > 计费 > IAP v4 > 市场PID管理。如果要显示的语言中没有产品名称，则显示输入的英文产品名称的内容。
• 支付方式设置可以在控制台 > 计费 > PG支付设置 > PG公司设置中进行

③ 调用PG公司的支付页面并在网页浏览器中显示该国的页面

• 当不是支付目标国家时，将显示错误页面

④ 支付完成后转到完成页面。完成页面以浏览器的语言显示。

在网上商店中实现PG支付¶

请按照以下步骤构建一个销售产品的网站。

① 通过访问控制台 > 应用中心来发放两个 AppID。

• 用于网页登录的AppID
  • 选择网页登录的AppID
  • 选择用作网站的用途
  • 如果您有现有的用于网站使用的AppID，您也可以使用现有的。
• 用于支付的AppID
  • 选择游戏AppID
  • 选择操作系统 - Windows，市场 - 直接分发

② 设置网页登录 AppID 的详细信息。

• 在登录信息中输入所有 IdP 密钥值
• 设置登录 IdP 使用
• 在 Web 登录操作设置中的重定向 URI 中输入登录后返回的网站地址

③ 通过前往控制台 > 账单 > 支付环境设置 > PG公司设置来注册PG公司信息。

④ 在步骤1中创建的支付AppID中注册市场PID，方法是前往控制台 > 计费 > 应用内支付 > 注册市场PID。

⑤ 使用网页登录 API 和网页 PG 支付 API 开发网站。

• 前往网页登录API
• 前往网页PG支付API

预工作¶

1. PG支付平台设置¶

• 使用PortOne时
  • 在PortOne管理控制台注册IAP服务器回调URL并设置PG公司
    • 在PortOne管理控制台>系统设置>Webhook设置中注册发送Webhook的公共URL
  • Webhook URL
    • 商业版: https://store.withhive.com/payment/result_processing/import
    • 沙盒版: https://sandbox-store.withhive.com/payment/result_processing/import 
  • 请注意
    • 由于PortOne不提供沙盒支付测试，我们建议使用以下方法进行测试。
    • 为商业服务和测试创建两个PortOne账户。PortOne控制台的管理员账户可以创建账户，而不考虑实际合同。
    • 在PortOne商业账户上注册商业URL，并在实际控制台上注册实际PG公司信息等。
    • 在PortOne测试账户上注册沙盒URL，并在沙盒控制台上注册测试PG公司信息等。
    • 如果仅使用一个实际PortOne账户进行商业服务，请在初次申请时连接沙盒，并在正式服务时更改为商业URL。
    • 在更改为商业URL后，请不要更改为沙盒地址。请注意，实际用户支付将被处理为测试支付。
    • 如果PortOne控制台将PG公司设置为测试，则交易历史将在第二天自动取消。商业服务中的游戏不得设置为测试。
• 使用Xsolla时
  • 向平台商务办公室请求创建子项目，并发放项目ID和密钥
• 通过直接合同使用MyCard时
  • 通过转到控制台>PG公司设置选择MyCard作为服务国家，并生成哈希密钥。
  • 在MyCard提供的注册表中输入控制台发放的哈希密钥以及IP、URL和客户公司注册信息并提交给MyCard。下载下面附加文件中的IP和URL信息。下载IP和URL信息
  • 之后，从MyCard接收FaServiceID并在控制台的PG公司设置中输入。
  • 请注意
    • 最低和最高支付金额根据每种支付方式的货币规定，因此在设置产品价格时请谨慎。
    • 当请求支付超出适用价格范围的产品时，将显示错误消息。

2. 控制台设置¶

• 价格层设置
  • 菜单位置：控制台 > 账单 > 商店价格管理 > 价格层
  • 价格层设置指南快捷方式
• 注册市场 PID
  • 菜单位置：控制台 > 账单 > 应用内购买 > 市场 PID 注册
  • 市场 PID 注册指南快捷方式
• PG 支付设置
  • 菜单位置：控制台 > 账单 > 支付环境设置 > PG 公司设置
  • PG 公司设置指南快捷方式

PG公司设置指南¶

设置将在游戏中使用的PG公司。设置完成后，PG公司无法被删除，只能被停用。

① 选择游戏：搜索一个游戏以检查所选的PG公司。如果您看不到游戏列表，请检查游戏权限。

② 添加游戏：移动到PG公司设置页面。

③ 按国家查看支付方式：检查您在弹出窗口中设置的PG公司的国家支付方式。

④ 修改：修改注册的PG公司详细信息。

通过游戏注册PG公司

点击“添加游戏”按钮以进入注册页面。

① 接收支付结果的 URL：如果您希望接收支付完成通知，请输入服务器 URL。

② 付款完成通知类型：在设置付款完成通知时选择通知类型。默认选项是“仅发送付款成功信息”。如果选择“发送所有”，接收通知的服务器必须配置付款成功和取消类型的分支逻辑。

③ PG平台的服务国家：您可以选择每个PG平台所服务的国家。下面的输入字段将根据所选选项进行更改。对于MyCard，仅在您拥有直接服务合同而不使用PortOne或Xsolla时选择。如果您更改服务国家，之前输入的信息将被删除，您需要重新输入详细信息以恢复到之前的服务国家。

1. 设置 PortOne

• PortOne 信息：输入在 I'mport 控制台系统设置中注册的相同信息。如果有子商店，您必须输入层级代码。当通过直接合同与 Naver Pay 连接时，您必须输入链 ID 值。
• PortOne - PG 公司支付方式：在 PortOne 管理员控制台中设置的 PG 公司列表会自动加载。在选择要使用的支付方式时，请检查 PG ID，并在 KCP 的情况下与 PortOne 管理控制台中相同地激活它。如果每个 PG ID 激活的支付方式与 PortOne 管理控制台不同，则将无法正确显示。如果将水平滚动条移动到最右侧，您将看到一个按钮，可以预览您设置的支付方式。如果您需要 PG 合同的支付测试页面，请复制预览页面的 URL 并提供给 PG 公司。

2. 设置 Xsolla

• Xsolla 信息：在 Xsolla 控制台 > 项目设置 > 常规设置中复制并输入项目 ID 和 webhook 密钥。
• Xsolla - PG 公司支付方式：为每个支持的国家选择一种支付方式。当您点击预览时，所有 Xsolla 已激活的支付方式都会显示，无论国家如何。

3. 设置 MyCard

• MyCard 信息：输入 MyCard 提供的 FaServiceID。认证号码（Hash）密钥会自动生成。复制生成的 HASH KEY，填写 MyCard 注册请求表，并提交给 MyCard。
• MyCard - PG 公司支付方式：仅提供 MyCard 作为支付方式。

PC支付查询和取消¶

在一个页面上查看PortOne或Xsolla的所有支付详情，如有必要可直接取消。Terminal 3的Paymentwall发送支付取消请求，而不是立即取消支付，是否已完成取消必须在终端3控制台中确认。

• PG公司和支付方式
  • 提供公司提供的所有PG的列表作为可选选择，无论支付方式在PG公司设置中是否已激活。
• 状态
  • PG
    • 支付完成 - 支付已成功完成
    • 支付失败 - 由于支付过程中出现错误等原因，支付失败。
    • 支付待处理 - 由于账户转账等原因，支付未立即完成。
    • 取消请求 - 请求取消支付
    • 取消完成 - 支付已正确取消。终端3支付无法确认取消是否已完成
    • 取消失败 - 取消请求失败
    • 未完成 - 由于用户关闭支付窗口或在支付前点击取消支付，支付未完成
  • Steam
    • 接收订单
    • 接受支付（用户）
    • 取消支付
    • 退款支付
    • 部分退款支付
    • 非法支付
    • 订单欺诈
    • 退单欺诈
    • 支付取消失败
• 总支付金额：总支付金额：所有搜索条件的总和，不包括未进展的情况
• 完成购买数量：购买完成计数：完成支付的数量，不包括取消的情况
• 总取消金额/取消：总取消金额/取消计数：取消案例的总金额和数量
• 产品价格：以价格层级中设置的显示货币的产品价格
• Game_Payload_info：从游戏服务器接收的值，用作通过物品支付结果传输API在分析中使用的附加指标
• IAP_Payload：应用开发者自定义的购买元数据
• 注意事项
  • 在更改之前的设置值的控制台上的支付历史记录，如果您在PG公司配置中修改选项值，则无法取消。
    • 示例1：如果您在PG公司设置中从使用Xsolla切换到PortOne，则无法在控制台中取消现有的Xsolla支付数据。
    • 示例2：如果在PG公司设置中使用了层级代码并随后删除，则在控制台中无法取消使用层级代码时的支付历史记录。
  • 如果您直接在I'mport控制台中取消支付详情，则根据PG公司，取消详情可能不会传递到控制台，因此请尝试通过面板取消。

PC支付项目重新处理¶

在此菜单中，您可以检查未正常完成的PG支付的详细信息。点击重新发送以完成支付流程并支付购买的产品。如果重新发送成功，它将从搜索结果中消失。

• 菜单位置：控制台 > 账单 > IAP v4 > PG支付完成未处理历史

符合加利福尼亚数字媒体消费者保护法（AB 2426）¶

• 根据加利福尼亚州“数字媒体消费者保护法（AB 2426）”的实施，必须告知消费者他们实际上并不拥有数字内容的购买权。反映此政策的通知会显示在PG支付用户界面中。此消息仅在国家设置为美国且语言设置为英语（en）时出现。
• 点击“了解更多”将打开在控制台 > 供应 > 条款中设置的服务条款链接。