文档中心 > 口碑手艺人

接口名称:alipay.offline.provider.useraction.record

接口描述:上传用户的手艺人订单信息到口碑开放平台,口碑开放平台会异步推送预订成功等信息给用户。

接口使用说明

上传频率:用户每个状态的订单都需要上传

source说明:从第三方平台进入开发者应用后产生的数据,传入第三方平台域名。比如当前数据是支付宝扫码后产生的,传入支付宝域名alipay.com,是在微信打开后产生的,传入微信域名weixin.qq.com,如果数据不是从第三方平台进入后产生的,设置自己的域名即可,该字段内容不做强制校验。

action_typeorder_pan

entityuser

action_detail说明:

参数名称 参数类型 是否必填 描述
orderAppId String 发生订单服务的APPID
subIndustry String 泛行业的子行业,详细见下文subIndustry说明
存在预设值校验,如果传入值不在subIndustry说明范围内,则校验不通过
outOrderId String 外部订单编号
shopName String 店铺名称
status Integer 当前订单状态
totalPrice Long 部分子行业必填 订单总金额,除团课预约、私教预约、预约试听-免费外都必填,单位为分
discountPrice Long 订单优惠金额,单位为分
channel String 支付来源渠道,取值范围:
  • alipay(支付宝支付)
  • weixin(微信支付)
  • offline(线下直接金额支付)
  • other(其他支付渠道)
  • red(红包)
  • pos(POS机器支付)
设置对应英文,多种渠道使用“|”分隔,比如使用支付宝支付与红包支付则传入:alipay|red
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 用户性别,取值范围:
  • M(男)
  • F(女)
cancelUserName String 取消用户名称
serviceInfo String 部分子行业必填 服务信息,需要场地信息的行业(如场馆预订等)该字段必填,如商品信息、场地信息等
targetName String 部分子行业必填 服务目标用户名称,服务目标非联系人时必填,如预约试听等
targetGender String 服务目标用户性别:
  • M(男)
  • F(女)
targetBirth String 服务目标用户生日,格式为yyyy-MM-dd

泛行业子行业对照表(subIndustry说明)

泛行业子行业名称 子行业编码
足疗养生 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)

订单状态status说明

异常完结状态:671 ~ 699

  • 已过期(671)
  • 已退款(672)
  • 订单已取消(673)
  • 扣费已取消(674)
  • 订单关闭(675)
  • 预订失败(676)

进行中状态:600 ~ 650

  • 待使用(600)
  • 待支付(601)
  • 待取件(602)
  • 待洗护(603)
  • 洗护中(604)
  • 待送件(605)
  • 待签收(606)
  • 退款中(607)
  • 待商家确认(608)
  • 订金待支付(609)
  • 尾款待支付(610)
  • 全款待支付(611)
  • 待拍摄(612)
  • 待用户选片(613)

正常完结状态:651 ~ 670

  • 已使用(651)
  • 预约成功(652)
  • 订单完成(653)

接口入参示例

{ 
    	"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"
    }
}

 

FAQ

关于此文档暂时还没有FAQ
返回
顶部