跳到主要内容

Steam 支付接入指引

准备接入 Steam 支付前请务必阅读 Steam 官方的最佳实践的建议！

如果是全球发行的游戏，请了解 Steam 所支持的币种，以此合理定价并了解汇率差可能对游戏收入有所影响。 关于商品价格的配置方式会在下面详细说明。

警告

Steam 黑卡泛滥，为了防范黑卡对游戏经济的破坏，我们已经针对 Steam 黑卡问题进行重点治理，风控策略会在Steam 交易风控部分进行说明。 我们强烈建议项目组对接 XDSDK 的退款通知功能，以便游戏侧可以及时收到因黑卡导致的退款并对黑卡用户进行处罚。

使用 XDSDK 对接 Steam 支付大致流程是：

  • 申请 Steam 支付参数，加入 Steam 开发者账号。
  • 将 Steam 支付数配置到 Silent 后台，支付参数配置暂不外开放，需要在 #xd-platform 频道提申请工单给 XDSDK 项管 。
  • 首次接入 XDSDK 支付功能还需将支付回调地址配置到 Silent 后台。
  • 在 Silent 后台配置不同地区的商品货币与价格。
  • 在 Silent 后台配置支付沙盒白名单。
  • 游戏项目组客户端对接 XDSDK Steam 支付模块，服务端对接支付回调接口。
  • 进行 Steam 沙盒支付测试。
  • 进行 Steam 真钱测试。
  • 撒花上线。

Steam 支付参数申请​

steam_payment_web_api

开通 XDSDK Steam 支付需要提供 Steam 的 AppId。

Steam 支付参数配置​

信息

该功能处于内测阶段，暂不对外。配置参数需要在 #xd-platform 频道发起申请，由 XDSDK 的技术支持或研发进行操作。

菜单路径: SDKV6 订单 → 支付渠道配置

  • Step1: 在 Silent 后台新增 Steam 支付渠道参数。 steam_payment_silent_payment_config_1
  • Step2: 将该 Steam 支付渠道配置关联到需要开通该种支付方式的游戏上。 steam_payment_silent_payment_config_2

游戏回调地址配置​

信息

首次接入 XDSDK 支付功能需要配置支付回调地址，非首次接入可按需配置。详情多回调地址说明。

菜单路径: SDKV6 订单 → API 配置列表

游戏可以自行配置不同的服务器或callbackCode对应的支付通知地址

steam_payment_silent_callback_config_1

游戏商品配置​

信息

玩家下单时所看到的货币单位和价格是什么，取决与用户 Steam 账户进行购买时所连入的国家/地区。

steam_payment_client_region_2

当用下单时，XDSDK 会获得 Steam 账户信息，其中有 用户进行购买时所连入的国家/地区，XDSDK 会通过 Steam 返回的 国家/地区判断该使用哪种货币单位与价格。

  • 如果该地区下的商品货币单位和价格已在 Silent 后台进行配置，那么 XDSDK 会直接使用该货币与价格向 Steam 发起支付请求。
  • 如果该地区下的商品未在 Silent 配置货币与价格，XDSDK 会使用默认货币单位(海外默认货币：美元)与默认价格向 Steam 发起支付请求。
  • 注意如果你配置的货币单位不在 Steam 支持的货币列表内，可能导致意料之外的情况出现。请不要这么做 :)

当我们向 Steam 请求交易的货币单位与玩家 Steam 账户钱包的货币单位不一致时，Steam 会自动换算成玩家钱包货币。

如果您不想每次以用户当地币种为交易定价，Steam 可以根据当前的汇率，自动将每次购买转换成用户当地币种。 
例如，如果您为 currency 传入的是 “USD”，为 amount 传入的是 “999”，则会按照当前汇率对俄罗斯的用户收取等值于 9.99 美元的卢布，在撰写此部分内容时为 614.90 戈比。

steam_payment_client_region_1

为了避免 Steam 自动转换货币的黑盒可能带来实际收入与预测收入的差距过大问题，我们建议针对 Steam 售卖的商品定价尽量覆盖热门地区。

Silent 菜单路径: SDKV6 订单 → 商品管理

Step1: 选择商品所支持的地区

steam_payment_silent_product_config_1

Step2: 配置各地区商品价格

当 Steam 玩家所在地区下的货币单位和价格未在 Silent 进行配置时，会使用下图中的默认价格。 steam_payment_silent_product_config_2

Step3: 下一步仅需选择支付子渠道

steam_payment_silent_product_config_3

Steam 沙盒支付​

Silent 菜单路径: SDKV6 订单 → 沙盒白名单

Steam 沙盒支付无需向 Steam 特别申请，只需在 Silent 后台通过 XDID 配置上沙盒白名单后即可在 Steam 支付时自动启用沙盒支付。

steam_payment_silent_whitelist_config_1

当 steam 付款页上显示的支付方式为 我的 Steam 钱包 (沙盒) 时，表示成功进入沙盒模式。

steam_payment_client_sandbox_1

Steam 退款测试​

当游戏服务端根据支付结果服务端回调文档完成对接工作后，即可开始进行退款测试。

测试方式与苹果退款测试 类似，需要平台的研发同学 Mock 一笔退款通知。

支付订单查询​

菜单路径: SDKV6 订单 → 订单信息

选择支付渠道为 Steam，查询沙盒支付/真钱支付订单状态、通知游戏状态码是否符合预期。

steam_payment_silent_order_query_1

Steam 交易风控​

关于 Steam 欺诈交易说明可以参见这篇文档

常见的欺诈形式为，欺诈者使用盗窃获得的支付方式（如信用卡）购买高价值物品与货币， 其目的是将虚拟物品转移至其他帐户。
这些帐户归欺诈者所有，或者属于在系统外购买这些物品的玩家。 另外，欺诈者也许会试图出售整个帐户，同样的，也是在系统之外收款。

游戏项目组需要做什么？

因黑卡导致退款的订单会通过支付结果服务端回调 将退款信息通知给游戏服务端。 我们强烈建议项目组对接该功能，这是游戏侧唯一能实时感知到黑卡用户的方式，并以此做出自己的策略，比如对使用黑卡的账户进行封号，收回道具等。

我们做了什么？

玩家下单前，我们会检查玩家的 Steam 账户状态， 如果是活跃付费玩家，不会受到任何支付限制。如果是未曾消费过的新用户，交易频率会收到限制。如果是已被 Steam 封号的用户将被禁止交易。

玩家付款后，我们会定期查询 Steam 订单状态，一旦发现订单被 Steam 退款或被标记为欺诈交易会立即对该笔订单发起退款并通知游戏。