接口名称:alipay.offline.provider.useraction.record
接口描述:上传用户的手艺人订单信息到口碑开放平台,口碑开放平台会异步推送预订成功等信息给用户。
上传频率:用户每个状态的订单都需要上传
source说明:从第三方平台进入开发者应用后产生的数据,传入第三方平台域名。比如当前数据是支付宝扫码后产生的,传入支付宝域名alipay.com,是在微信打开后产生的,传入微信域名weixin.qq.com,如果数据不是从第三方平台进入后产生的,设置自己的域名即可,该字段内容不做强制校验。
action_type:order_pan
entity:user
action_detail说明:
| 参数名称 | 参数类型 | 是否必填 | 描述 |
|---|---|---|---|
| orderAppId | String | 是 | 发生订单服务的APPID |
| subIndustry | String | 是 | 泛行业的子行业,详细见下文subIndustry说明 存在预设值校验,如果传入值不在subIndustry说明范围内,则校验不通过 |
| outOrderId | String | 是 | 外部订单编号 |
| shopName | String | 是 | 店铺名称 |
| status | Integer | 是 | 当前订单状态 |
| totalPrice | Long | 部分子行业必填 | 订单总金额,除团课预约、私教预约、预约试听-免费外都必填,单位为分 |
| discountPrice | Long | 否 | 订单优惠金额,单位为分 |
| channel | String | 否 | 支付来源渠道,取值范围:
|
| payOrderNo | String | 否 | 支付订单号 |
| payTime | Long | 否 | 支付时间,时间戳(精确到毫秒) |
| closeReason | String | 否 | 关闭/取消原因 |
| detailUrl | String | 是 | 订单详情页链接 传入的URL必须与开放平台后台,应用APPID配置的授权URL的域名相同,保证后续网页授权可以跳转过去。 例如:上传的detailUrl=http://XXXXX.com?orderId=1234,口碑会在当前URL上追加&openAppId=X&shopId=口碑店铺ID&bizScenario=XX。网页授权成功后跳转到ISV平台,URL会是:http://XXXXX.com?orderId=1234&openAppId=X&shopId=口碑店铺ID&bizScenario=XX&app_id=XXX&source=alipay_wallet&scope=auth_base&auth_code=ca34ea491e7146cc87d25fca24c4cD11 ,后继ISV就可以完成自己的业务逻辑,比如解析orderId、auth_code参数。然后ISV通过接口alipay.system.oauth.token根据auth_code查询支付宝会员信息,详见网页授权文档。 |
| description | String | 否 | 描述、备注(长度不超过500个字符) |
| productName | String | 是 | 产品名称 |
| serviceTime | String | 是 | 服务时间,格式:yyyy-MM-dd HH:MM:ss,如拍摄时间等 |
| serviceDuration | Integer | 否 | 服务时长,秒数 |
| operatorName | String | 部分子行业必填 | 服务操作人名称,摄影行业、私教必填,如摄影师名称等 |
| operatorId | String | 部分子行业必填 | 服务操作人外部ID,当服务操作人名称不为空,该字段也不能为空,如摄影师外部ID等 |
| operatorPhone | String | 否 | 服务操作人电话号码 |
| contact | String | 否 | 联系人 |
| shopPhone | String | 否 | 店铺电话 |
| productCount | Integer | 部分子行业必填 | 产品数量,如摄影的套餐数量等 |
| pict | String | 否 | 图片链接 |
| userAddress | String | 部分子行业必填 | 用户地址,需要上门服务的必填,如洗衣等 |
| userGender | String | 否 | 用户性别,取值范围:
|
| cancelUserName | String | 否 | 取消用户名称 |
| serviceInfo | String | 部分子行业必填 | 服务信息,需要场地信息的行业(如场馆预订等)该字段必填,如商品信息、场地信息等 |
| targetName | String | 部分子行业必填 | 服务目标用户名称,服务目标非联系人时必填,如预约试听等 |
| targetGender | String | 否 | 服务目标用户性别:
|
| targetBirth | String | 否 | 服务目标用户生日,格式为yyyy-MM-dd |
| 泛行业子行业名称 | 子行业编码 |
|---|---|
| 足疗养生 | ZuLiao |
| 预约视听 | ShiTing |
| 预约视听-免费 | ShiTingFree |
| 私教预约 | SiJiao |
| 场馆预订 | ChangGuan |
| 洗衣 | XiYi |
| 摄影行业 | SheYing |
| 团课预约 | TuanKe |
| 手艺人预约 | ShouYiRen |
| 先享后付 | XianXiangHouFu |
| 包厢预订 | BaoXiang |
| 子行业 | 必填字段 | 可用状态 |
|---|---|---|
| 包厢预定 | serviceInfo, totalPrice |
待支付(601)、待使用(600)、已使用(651)、已过期(671)、已退款(672)、退款中(607)、订单已取消(673) |
| 手艺人预约 | operatorName, operatorId |
待商家确认(608)、预约成功(652)、预约失败(676)、已过期(671)、待支付(601)、未消费(600)、已消费(651)、已过期(671)、已退款(672)、退款中(607)、订单已取消(673) |
| 先享后付 | totalPrice | 待支付(601)、已支付(654)、订单完成(655)、订单关闭(675)、已过期(671)、订单已取消(673)、已退款(672) |
| 摄影选套餐 | totalPrice, operatorName, operatorId, productCount |
待商家确认(608)、订金待支付(609)、尾款待支付(610)、全款待支付(611)、预订成功(652)、待拍摄(612)、待用户选片(613)、预订失败(676)、订单完成(653)、订单关闭(675)、退款中(607)、已退款(672) |
| 足疗预订 | totalPrice | 待商家确认(608)、待支付(601)、待使用(600)、预订成功(652)、预订失败(676)、已使用(651)、订单关闭(675) |
| 洗衣 | totalPrice, userAddress, contact, serviceInfo |
待支付(601)、待取件(602)、待洗护(603)、洗护中(604)、待送件(605)、待签收(606)、订单完成(653)、订单关闭(675)、退款中(607)、已退款(672) |
| 预约试听 | operatorName, operatorId, totalPrice |
待使用(600)、已使用(651)、待支付(601)、已过期(671)、已退款(672) |
| 预约试听-免费 | targetName | 预约成功(652) |
| 场馆预订 | totalPrice, serviceInfo |
待使用(600)、待支付(601)、已过期(671)、已退款(672)、651(已使用) |
| 团课预约 | 待使用(600)、已过期(671)、订单已取消(673)、扣已取消(674)、已使用(651) | |
| 私教预约 | operatorName, operatorId |
待使用(600)、已过期(671)、订单已取消(673)、扣已取消(674)、已使用(651) |
异常完结状态:671 ~ 699
进行中状态:600 ~ 650
正常完结状态:651 ~ 670
{
"biz_content": {
"action_detail": {
"detailUrl": "https://www.baidu.com/platform/login/thirdlogin?orderId=d2229fded4254f19b157f97b4ddb9516",
"orderAppId": "2016061501149129",
"outOrderId": "d2229fded4254f19b157f97b4ddb9516",
"productName": "足疗养生",
"serviceTime": "2017-02-17 20:11:54",
"shopName": "测试-爽到家23",
"status": 600,
"subIndustry": "ZuLiao",
"totalPrice": "100"
},
"action_outer_id": "d2229fded4254f19b157f97b4ddb9516",
"action_type": "order_pan",
"date_time": "2017-02-17 16:35:54",
"entity": "user",
"industry": "PAN",
"mobile": "13588304273",
"outer_shop_do": {
"outer_id": "2016101700077000000003436443",
"shop_id": "2016101700077000000003436443",
"type": "baidu.com"
},
"source": "baidu.com",
"user_id": "2088902248579233"
}
}