交易
交易让父母能够查看并控制孩子在已接入应用中的购买。您的产品向 k-ID 报告购买,并在您希望在扣款前让父母参与其中时,先请求他们批准。k-ID 记录购买、保存批准状态、通知父母,并把结果告知您。资金如何处理仍由您的产品决定。
购买按孩子、按会话报告,因此父母读到的是孩子在您产品中购买记录的一份连续历史,而不是按设备或按收据的视图。
父母可以看到什么
交易之下有两项能力,产品可以单独使用其中任意一项:
- 购买可见性。 您的产品报告已完成的购买,k-ID 将它们呈现给已关联的父母,既作为 Family Connect 中按孩子的购买视图,也作为定期活动摘要中的一行。这是报告:它不会拦截任何购买,也不会要求任何人采取行动。
- 购买批准。 在某笔具体扣款之前,您的产品请求父母对其进行批准。k-ID 保存请求、通知父母,并以 Webhook 的形式返回他们的答复。这是把父母置于购买之前的部分。
两者相互独立。产品可以在从不请求批准的情况下报告购买,可以对部分购买请求批准而报告全部购买,也可以单独使用批准。
职责边界
k-ID 记录购买、保存批准请求、通知父母并报告结果。您的产品决定什么是一笔购买、是否扣款以及何时询问。
k-ID 从不处理支付、转移资金或拦截扣款。它不见证交易。当您请求父母批准一笔购买时,k-ID 返回他们的决定;未作答或被拒绝的请求是否会阻止扣款,由您的产品执行。
报告购买
每笔购买是一条扁平记录:一个标题和可选描述,原样展示给父母;一个以货币最小单位表示的 amount;一个 currency;完成时的 timestamp;一个可选的 url,父母可在此管理该购买(例如取消订阅);以及一个为 successful 或 failed 的 status。
报告 failed 扣款很重要:它让父母能够区分一笔已经完成的购买和一笔尝试过但未成功的购买。订阅续费在每次扣款时都作为一笔购买报告。
购买还会汇入受信任的成年人所读到的活动,因此这些金额会出现在定期摘要和购买视图中。端点及其逐条结果的形态请参阅交易集成指南。
请求父母批准购买
当您希望在扣款前获得父母的决定时,您的产品针对会话发起一个批准请求。k-ID 通知父母,父母在 Family Connect 中批准或拒绝,结果作为携带 approved、denied 或 expired 的 Transaction.PurchaseApprovalResult Webhook 到达。
- 在扣款前询问。 该请求是您置于购买之前的一道关卡,而不是购买之后的收据。只有在批准到达后才完成购买。
- 无人答复的请求会在 24 小时后到期。 到期是通过同一个 Webhook 报告的正常结果,而不是失败。可以再次向玩家提供该购买。
- 请求携带截止时间。 请把请求返回的
expiresAt当作答复不再可能到来的时点,而不要无限期等待 Webhook。
请求与 Webhook 的形态请参阅请求批准。
交易与支付即验证
在司法管辖区认可的情况下,一笔已完成的卡支付也可以替代父母同意。这就是支付即验证,一项依托同一交易配置的独立能力。它关乎同意,而非可见性,并在其自己的页面上介绍。
启用交易
交易默认关闭,在 Compliance Studio 中按产品启用。在开启之前,交易端点会返回 FEATURE_DISABLED。设置步骤请参阅交易集成指南。