跳到主要内容

接入指引

开通平台支付

如果游戏还没有开通过 XD Client,请按照 XD SDK 需求及流程规范 进行申请,并在申请中说明游戏需要开通的支付渠道。

支付渠道参数申请

每个游戏会有单独的某个支付渠道的参数需要向支付渠道申请,这个过程平台会配合游戏一起向支付渠道申请。目前大部分支付渠道的申请都是产品和商务发起的,并在微信群或者 Slack 上沟通。

支付渠道参数可能会分为测试环境参数和正式环境参数,这两个环境的申请可能是串行的也可能上并行的,具体情况依据不同渠道的要求而定。和支付渠道的沟通和协调往往可能比较耗时。

支付渠道参数配置

支付渠道参数申请成功后通过邮件私发给平台研发,配置到平台后才算是某个支付渠道开通了。

商品管理

配置商品请参考 SDK6.X 商品新增说明(试行),依照 XD SDK 需求及流程规范 进行申请配置。商品更新和增减同样按照上述流程申请变更。

游戏对接

客户端

请参考 支付系统-客户端开发指南

服务端

根据 支付系统-服务端对接,还需要游戏服务端提供以下接口供平台调用:

服务端涉及到的公钥请向平台研发索要,平台研发会把公钥私发给游戏的研发。

信息

请不要在公开的沟通渠道泄露支付渠道秘钥。

测试

沙盒测试

沙盒支付账号:XDSDK 拥有部分沙盒测试账号,如需使用请在 Slack 频道 #xd-platform 提出申请,并提交 Jira 工单给许嘉褀。

沙盒支付白名单:只有加入沙盒支付白名单的账号才会走沙盒支付,请在该项目的 Silent 后台SDK V6 订单 - 沙盒白名单 自行添加。

真钱测试

游戏上线前必须把支付渠道参数替换成的正式支付渠道参数,同时如果要用之前已经加了沙盒支付白名单的账号进行真钱测试,则需要在 Silent 后台将白名单去除。

除极少一部分支付渠道(如 MyCard)会提供真钱账号用于测试外,大部分支付渠道的真钱测试都需要测试人员真实付钱。

正式对外开放充值之前,强烈建议游戏对每个支付渠道的可用性进行真钱测试。

测试账号

XDSDK 拥有以下渠道的测试账号,如需使用,请在 Slack 频道 #xd-platform 提出申请,并提交 Jira 工单给许嘉褀。

国内

渠道名沙盒真钱
支付宝
ping++
微信

海外

渠道名沙盒真钱
Razer
Unipin
MyCard 台湾
MyCard
Paypal
OnePay
支付宝(Alipay)
支付宝香港(AlipayHK)
Codapay
Toss
ApplePay
GooglePay

上线

如果游戏预计流量会比较大,建议上线前提前通知平台研发做好服务器容量预估和值班安排,以应对突发情况。

订单管理

游戏运营和客服可能有查询到订单的需求,请在 Silent-SDK V6 订单 自行查看。

数据分析

TapDB

平台服务端在玩家支付完成后会把支付金额上传至 TapDB(ClientID 同游戏使用的 TapClientID),具体上报内容见 TapDB 文档 上报充值记录 部分的说明。

为了方便对 Apple/Google 支付进行数据分析,我们会将客户端侧得到的用户付款货币与付款金额一同上报,所以会比 TapDB 文档内多 2 个上报参数

#client_currency_type 客户端充值货币类型
#client_charge_amount 客户端充值金额

需要注意:

  • TapDB 并没有对 order id 做去重幂等,且 TapDB 基于日志的数据分析系统通常多用于趋势的分析,不要求对账级别的精确度。
  • TapDB 的收入数据并不包含退款数据的扣减。因此 TapDB 的收入数据严格上来说不适用于财务对账,只做趋势分析参考。

不过目前暂未发现支付数据上传到 TapDB 的明显重传,TapDB 显示的收入数据和实际的收入数据差距较大的情况暂未出现过。