跳到主要内容
版本:v6

Apple Pay 接入指引

整体情况介绍​

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

功能开启和配置​

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

退款通知配置​

enable_sign_in_with_apple

信息

XDSDK 服务端已支持 V2 版本的退款通知,同时兼容 V1 版本。通知版本可选择 V2;下图为旧版配置示意,截图中选择的 V1 并非必选项。

enable_sign_in_with_apple

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

V1、V2 版本的退款通知使用相同的回调 URL。URL 中的 /callback/v1/ 为 XDSDK 服务端接口路径,与 Apple 通知版本无关,选择 V2 时无需修改。

将 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 和游戏的退款通知测试可以参考 如何测试退款。

真钱测试​

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

正式上线​

暂无特别需要注意的。