接口名称: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" } }