跳到主要内容

Apple Pay 接入指引

整体情况介绍

Apple Pay 的接入流程相对比较成熟,接入和测试时间相对可控。

功能开启和配置

具体开通步骤参考 Apple 官网文档。如果需要协助可以联系公关部门处理。 开通 Apple Pay 之后可能还需要进行下面的配置。

退款通知配置

enable_sign_in_with_apple

危险

XDSDK 服务端暂时只支持 V1 版本的通知,因此通知版本请选择 V1 版本,否则无法正常处理退款通知。

enable_sign_in_with_apple

生产环境服务器 URL 模版: {host}/callback/v1/extern/refund/0/ApplePay/{appId}/notify

将 appId 变量替换,比如海外 demo 的 XD AppId 为 1111,则需要配置的退款 URL 是: https://xdsdk-intnl-6.xd.com/callback/v1/extern/refund/0/ApplePay/1111/notify

区域host
海外https://xdsdk-intnl-6.xd.com
国内https://xdsdk-6.xd.cn

只有配置了退款通知游戏服务器才会有 服务端退款通知

XDSDK 配置参数

在支付开通的 Jira 单子中提供 bundle ID 比如:com.xd.sdkdemo1 用于 XDSDK 服务端校验,由项管安排 XDSDK 研发或者技术支持进行配置。

项目组研发接入

XDConfig.json 文件模版说明bundle_id 字段进行配置。

项目组测试

测试过程遇到问题请先参考 FAQ 进行排查,如无法解决请通过 #xd-platform 联系技术支持和研发排查。

沙盒测试账号

请参考 Apple Pay 沙盒测试的官方文档,自行申请账号并自行测试。

沙盒支付白名单

未添加沙盒支付白名单通过 Apple 沙盒测试账号下单的订单是无法到账的,因此需要添加沙盒支付白名单。

可以提供对应的 xdid (复制用户中心上的 id 即可) 和使用人名字通过 Jira 提交给 TDS 项管。为了提升沟通效率,请批量提交!

退款测试

Apple Pay 支持 退款通知,但 Apple Pay 的沙盒环境无法走完整的退款流程用于测试。XDSDK 和游戏的退款通知测试可以参考 如何测试退款

真钱测试

游戏项目组需要自行进行真钱测试。

正式上线

暂无特别需要注意的。