接入流程

本文介绍如何申请应用内购接口调用权限，以及内购商品购买流程。

内购接口权限申请

在调用内购相关接口前，，需要先申请接口权限：

登录开发者后台，单击目标应用打开详情页。

在权限管理页面，单击应用内购。

选择应用内购相关接口权限，单击申请权限。
应用内购添加接口权限

内购商品购买流程（非iOS）

非iOS用户内购系统间交互流程如下图所示，请注意：

ISV在接收到支付成功回调通知后进行业务的开通处理，并在处理成功后调用/appstore/internal/order/finish接口通知钉钉该笔订单已完成处理。

支付成功回调通知时如果通知失败(如网络异常)，钉钉侧将进行通知重试，因此ISV对支付成功回调通知的处理需要保持幂等。

第四步“购买成功”跳转的目标页面地址为ISV调用/appstore/internal/skupage/get接口时传入的callback_page参数。

微应用场景：callback_page必须与微应用首页页面同域名

小程序场景：callback_page必须为小程序内的页面

注意

跳转到目标页面不能作为“购买成功”的判断依据，判断购买成功需要根据服务端“支付成功回调通知”判断。

第三步“支付成功回调通知”可能晚于第四步“购买成功”。因此ISV在服务的如果发现权限还未开通，可通过“购买成功”时回传的订单号查询该订单是否已完成支付。如果已完成支付，ISV可进行权益的开通处理。
内购流程非ios

内购商品购买流程（iOS）

iOS用户内购系统间交互如下图所示。

内购商品目前暂不支持iOS用户在手机端直接完成支付购买。用户可以通过DRP分销平台，联系代理服务商为iOS用户进行内购商品的代下单。下单后用户将收到支付提醒消息，完成支付后，钉钉侧将通过回调通知ISV。
内购商品流程ios

内购商品核销

对于消耗型商品，用户在使用商品时，ISV完成自身的业务逻辑处理后，需要调用钉钉的商品消耗接口，对指定订单商品进行消费。
内购商品核销

异常场景处理

由于异步支付成功回调通知在特殊异常场景，例如网络异常导致多次重试仍未正常处理，可能导致ISV未处理用户已支付的订单。为防止内购商品掉单，确保用户支付的每一笔内购订单ISV都有进行处理，钉钉侧提供服务端接口给ISV，用于查询所有未处理的已支付订单信息。建议ISV每日定时调用该接口获取已支付订单进行补偿处理。

接口名：/appstore/internal/unfinishedorder/list

通知回调

HTTP回调通知

触发条件：用户的内购订单支付成功后触发

说明：用户购买第三方企业应用，成功跳转到ISV应用页面时，建议仅作为指导用户的后续操作，根据通知消息或者通过订单号查询用户订单信息来判断订单的真实支付状态。

POST数据解密后示例

{
    "orderType": "BUY",
    "EventType": "market_buy",
    "orderId": 208784230790568,
    "openId": "UfcvaQfACHc1oqX*****",
    "itemCode": "DD_I-***",
    "saleModelType": "CYC_UPGRADE",
    "mainGoodsName": "测试123",
    "maxOfPeople": 0,
    "itemName": "专业版",
    "payFee": 1,
    "serviceStopTime": 1681056000000,
    "serviceStartTime": 1617935090000,
    "mainGoodsCode": "FW_GOODS-123455",
    "appId": "2148",
    "goodsName": "测试商品123",
    "SuiteKey": "suite4****",
    "minOfPeople": 0,
    "orderCreateSource": "APPSTORE",
    "buyCorpId": "ding123456",
    "unionId": "dfafaf33131",
    "extendParam": "{\n  \"userId\" : 123456\n}",
    "goodsCode": "DD_GOODS-123445",
    "paidtime": 1617935090000
}

数据推送

**触发条件：**用户的内购订单支付成功后触发，插入表open_sync_biz_data中。

订单信息，biz_type = 17，使用请参考数据格式。

在原订单数据的基础上，内购订单数据信息新增如下字段：

appId：内购应用ID。

订单到期或者用户退款等导致的服务关闭，目前仅推送因用户退款导致的服务关闭，biz_type = 37，使用请参考数据格式。

内购接口权限申请#

内购商品购买流程（非iOS）#

内购商品购买流程（iOS）#

内购商品核销#

异常场景处理#