用户购买下单事件

本文介绍了用户购买下单事件的相关说明。

此事件的推送会发生在企业在钉钉应用市场下单购买应用后，向ISV应用回调地址POST数据。

说明

用户购买下单事件适用于第三方企业应用。

POST数据解密后示例：

{
    "SuiteKey": "xxxxxx",
    "EventType": "market_buy",
    "orderId": 308356401,
    "goodsCode": "FW_GOODS-xxxxxxxx",
    "goodsName": "测试上001",
    "buyCorpId": "xxxxxx",
    "corpId": "xxxxxx",
    "itemCode": "1c5f70cf04c437fb9aa1b20xxxxxxxx",
    "itemName": "按照范围收费规格0-300",
    "subQuantity": 1,
    "maxOfPeople": 300,
    "minOfPeople": 0,
    "serviceStopTime": 1477065600000,
    "paidtime": 1474535702000,
    "orderCreateSource": "APP-STORE",
    "buyUserId": "staff2313",
    "articleType": "normal",
    "originalArticleCode": "DT_GOODS_23311",
    "originalItemCode": "DT_GOODS_23311_123",
    "payFee": 147600,
    "nominalPayFee": 147600,
    "discountFee": 600,
    "discount": 0.06,
    "distributorCorpId": "xxxxxx",
    "distributorCorpName": "测试企业",
    "serviceStartTime": 1477065500000,
    "orderType": "BUY",
    "orderChargeType": "FREE",
    "saleModelType": "CYC_UPGRADE",
    "openId": 3412321001,
    "unionId": "gliiW0piiii02zBUjUxxxx",
    "outTradeNo": 209310000312,
    "mainGoodsCode": "DT_GOODS_39001",
    "mainGoodsName": "测试商品002",
    "orderChannelCode": "all_star_isv_channel_code",
    "appId": 299011,
    "extendParam": {
        "name": "***"
    },
    "isvOperationCode": "*****",
    "solutionPackageKey": "SOLUTION313-31231",
    "solutionPackageName": "中小企业财务解决方案",
    "mainCorpId": "ding23093214311",
    "autoChangeFreeItem": false,
    "orderLabel": 1,
    "presentRelMainOrderId": 209130000311,
    "leadsFrom": "广场-搜索",
    "purchaseType": 1
}

参数说明：

参数	说明
SuiteKey	用户购买的应用的SuiteKey。
EventType	回调事件类型。
corpId	购买该应用企业的corpid。
buyCorpId	购买该应用企业的corpid。

注意

BUY：新购
RENEW：续费
UPGRADE：升级
RENEW_UPGRADE：续费升配
RENEW_DEGRADE：续费降配

|
|orderChargeType|订单收费类型，取值

FREE：免费开通
TRYOUT：试用开通

说明

仅针对试用规格。|
|saleModelType|售卖模式，取值：

CYC_UPGRADE_MEMBER：按周期 + 数量（人数）售卖
CYC_UPGRADE：按周期售卖
QUANTITY：按数量（人数）售卖

说明

内购订单时该字段有值。|
|purchaseType|购买类型，取值：

1：组织购买
2：个人购买

说明

当订单为解决方案时该字段有值。|
|solutionPackageName|解决方案名称。

说明

说明

付费商品如果有免费规格，试用到期后会系统自动下单转免费规格，包含此订单标记。|
|orderLabel|订单标记，取值：

0：普通订单
1：满赠订单

工作台-底部推荐
工作台-分组推荐
工作台-分组更多-顶部推荐位
工作台-应用图标推荐
广场-搜索
广场-banner
广场-专题
广场-商品推荐
应用中心-新企业管理员推荐
应用中心-搜索
应用中心-banner
应用中心-专题
应用中心-全部应用(安卓)
应用中心-解决方案
人事专区
开发者后台-推广码
PC应用中心

应用在收到此事件推送后务必返回包含经过加密的字符串"success"的JSON数据。只有返回了对应的JSON数据，钉钉才会判断此事件推送成功。

{
  "msg_signature":"111108bb8e6dbce3c9671d6fdb69d15066227608",
  "timestamp":"1783610513",
  "nonce":"123456",
  "encrypt":"1vn9lYTuuHSoaxwCGylH9xRhasdfghjkl" // "success"字段的加密数据
}

其中：

msg_signature：消息体签名。

timestamp：时间戳。

nonce：随机字符串。

encrypt："success"的加密字符串。