钉钉开发文档

用户购买下单事件

更新时间: 2018-6-8

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

POST数据解密后示例

{
    "EventType": "market_buy",
    "SuiteKey": "suited6db0pze8yao1b1y",
    "buyCorpId": "dingxxxxxxxx",
    "goodsCode": "FW_GOODS-xxxxxxxx",
    "itemCode": "1c5f70cf04c437fb9aa1b20xxxxxxxx",
    "itemName": "按照范围收费规格0-300",
    "subQuantity": 1(订购的具体人数),           
    "maxOfPeople": 300,
    "minOfPeople": 0,
    "orderId": 308356401xxxxxxxx,
    "paidtime": 1474535702000,
    "serviceStopTime": 1477065600000,
    "payFee":147600,
    "orderCreateSource":"DRP",
    "nominalPayFee":147600,
    "discountFee":600,
    "discount":0.06,
    "distributorCorpId":"ding9f50b15bccd16741",
   	"distributorCorpName":"测试企业"
}

参数说明

参数 说明
EventType market_buy
SuiteKey 用户购买应用的SuiteKey
buyCorpId 购买该应用企业的corpid
goodsCode 购买的商品码
itemCode 购买的商品规格码
itemName 购买的商品规格名称
maxOfPeople 购买的商品规格能服务的最多企业人数
minOfPeople 购买的商品规格能服务的最少企业人数
orderId 订单id
paidtime 下单时间
serviceStopTime 该订单的服务到期时间
payFee 订单支付费用,以分为单位
orderCreateSource 订单创建来源,如果来自钉钉分销系统,则值为"DRP"
nominalPayFee 钉钉分销系统提单价,以分为单位
discountFee 折扣减免费用
discount 订单折扣
distributorCorpId 钉钉分销系统提单的代理商的企业corpId
distributorCorpName 钉钉分销系统提单的代理商的企业名称

返回参数说明

服务提供商在收到"用户下单购买"事件推送后务必返回包含经过加密的字符串"success"的json数据。

{
  "msg_signature":"111108bb8e6dbce3c9671d6fdb69d15066227608",
  "timestamp":"1783610513",
  "nonce":"123456",
  "encrypt":"1ojQf0NSvw2WPvW7LijxS8UvISr8pdDP+rXpPbcLGOmIBNbWetRg7IP0vdhVgkVwSoZBJeQwY2zhROsJq/HJ+q6tp1qhl9L1+ccC9ZjKs1wV5bmA9NoAWQiZ+7MpzQVq+j74rJQljdVyBdI/dGOvsnBSCxCVW0ISWX0vn9lYTuuHSoaxwCGylH9xRhYHL9bRDskBc7bO0FseHQQasdfghjkl" // "Random"字段的加密数据
}

参数 说明
msg_signature 消息体签名
timestamp 时间戳
nonce 随机字符串
encrypt "success"加密字符串