更新时间:2024-10-23 18:07:06配置项检测工具收藏订阅更新我的文档设置接入检测(即可查看检测结果)若有未通过的接入检测项,接口将无法调通去登录返回文档商家需通过 alipay.merchant.order.sync(订单数据同步接口) 订单扩展字段 ext_info#merchant_order_status 参数更新订单状态,上门服务专用状态如下。订单状态流转说明订单状态流转图说明:左侧表示起始状态,右侧表示允许的后置状态。订单状态说明●支持跨状态传递,如:book_successfully(预约成功)可直接跳转至 wait_pay(待支付)。●不要求首次同步订单状态必须为 book_successfully(预约成功)。●当前场景定义的订单状态(中文和英文名)如下:注意:不同订单状态,仅 是否发送服务消息 为 是 时,用户才能在 消息列表(支付宝凯发k8官方网娱乐官方首页服务提醒入口进入或凯发k8官方网娱乐官方首页底部消息 tab 进入)查看服务订单消息提醒。状态中文名状态英文名是否发送服务消息预约成功book_successfully是派单中to_send否已接单order_taken是二段报价second_offer否二段支付成功repaid否待服务to_be_service否待验收to_be_acceptance否申请售后after_sales否服务已验收acceptance否订单完成finished是已取消closed是服务中servicing否服务完成serviced否待支付wait_pay否不同状态参数使用说明预约成功 (book_successfully)本文详细介绍通过 alipay.merchant.order.sync 接口同步订单状态-预约成功(book_successfully)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_status。l ext_valuestring是是否订单状态, 例: book_successfully。l ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否是订单详情地址 key。固定为 merchant_order_link_page。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数。业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否是字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准),文本信息。notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring否否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否是字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否是字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring否否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring是否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件获取的 material_id。派单中 (to_send)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-派单中 (to_send)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认 alipay(支付宝小程序),钉钉来源 dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: to_sendl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否否字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准),文本信息。notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring否否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否否字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否否字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring否否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring否否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。已接单 (order_taken)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已接单 (order_taken)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: order_takenl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否是字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准);文本信息notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring是否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否是字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否是字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring是否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring否否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。二段报价 (second_offer)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-二段报价 (second_offer)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: second_offerl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否否订单详情地址 key。固定为 merchant_order_link_page。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否否字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准);文本信息notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring是否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否否字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否否字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring是否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring否否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。待支付 (wait_pay)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待支付 (wait_pay)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: wait_payl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否否字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准);文本信息notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring否否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否否字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否否字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring否否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring否否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。二段支付成功 (repaid)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-二段支付成功 (repaid)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源 dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: repaidl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否否字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准);文本信息notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring是否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否否字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否否字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring是否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring否否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。待服务 (to_be_service)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待服务 (to_be_service)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: to_be_servicel ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否否字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准);文本信息notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring是否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否否字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否否字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring是否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring否否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。待验收 (to_be_acceptance)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待验收 (to_be_acceptance)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源 dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: to_be_acceptancel ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否否字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准);文本信息notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring是否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否否字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否否字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring是否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring否否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。申请售后 (after_sales)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-申请售后 (after_sales)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: after_salesl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否否字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准);文本信息notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring是否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否否字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否否字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring是否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring否否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。服务已验收 (acceptance)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-服务已验收 (acceptance)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源 dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: acceptancel ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否否字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准);文本信息notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring是否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否否字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否否字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring是否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring否否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。订单完成 (finished)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-订单完成 (finished)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: finishedl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否是字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准);文本信息notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring是否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否否字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否是字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring是否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring否否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。已取消 (closed)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-已取消 (closed)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否是外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源 dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: closedl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否是订单详情地址 key。固定为merchant_order_link_page。l ext_valuestring是否是商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否是字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准);文本信息notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring否否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否否字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否是字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring否否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring否否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。服务中 (servicing)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-服务中 (servicing)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文 商品信息列表。trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: servicingl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否否字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准);文本信息notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring否否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否否字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否否字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring否否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring否否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。服务完成 (serviced)本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-服务完成 (serviced)时需传入的商品信息及扩展字段参数信息。接口参数 bizcontent 示例 参数说明参数类型是否必填能否更新是否消息使用字段参数说明out_biz_nostring是否否外部订单号。由商家自定义。 注意:同一笔订单更新状态时,需与首次同步入参一致。buyer_id(buyer_open_id)string是否否支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 openid配置申请。order_typestring是否否订单类型。固定为service_order(服务订单)。order_create_timestring是否否订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。order_modified_timestring是是否订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time较晚的同步会被最终存储,order_modified_time相同的两次同步会被幂等处理。source_appstring否否否订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。ext_infoorderextinfo是是否订单扩展字段。详情可查看下文 订单扩展字段。item_order_listitemorderinfo是否否商品信息列表。详情可查看下文: 商品信息列表trade_nostring否否否支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。amountprice选填,建议传入 (当支付宝交易号trade_no或pay_amount为必传时须传入amount)是否订单总金额。精确到小数点后两位,单位为 元。pay_amountprice选填,建议传入该参数否否实际支付金额。精确到小数点后两位。单位为 元。discount_amountprice否否否优惠金额。传入 discount_info_list 时必填。单位为 元。订单扩展字段开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明l ext_keystring是否否订单状态 key。固定为 merchant_order_statusl ext_valuestring是是否订单状态, 例: servicedl ext_keystring是否否订单类型 key。固定为 merchant_biz_type。l ext_valuestring是否否订单类型 value。本业务场景为: door_to_door_service。l ext_keystring是否否订单详情地址 key。固定为merchant_order_link_page。l ext_valuestring是否否商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185。l ext_keystring是否否商家小程序 appid key。固定为 tiny_app_id。l ext_valuestring是否否商家小程序 appid value。传入订单归属的小程序 appid。l ext_keystring是否否订单业务场景相关的信息 key。固定为 business_info。l ext_valuejsonstring是是否订单业务信息详情 value。入参详情见下文 业务信息参数业务信息参数业务信息参数(business_info) 的各项入参详情如下:参数类型是否必填能否更新是否消息使用字段参数说明server_namestring是否否字段名称:服务名称 字段说明:商家三级类目(sku,已有独立url为判断标准);文本信息notestring否否否字段名称:服务特殊要求 字段说明:预约上门服务次数person_typestring否否否字段名称:服务人员类型 字段说明:服务人员的类型,如育婴师、美容师、保洁师、搬家人等contractor_namestring否否否字段名称:承接商名称 字段说明:承接该服务的商家名称platform_phonestring是否否字段名称:平台商电话 字段说明:需要为标准服务电话platform_namestring是否否字段名称:平台商名称 字段说明:承接服务的平台商名称door_start_timestring是否否字段名称:预约上门开始时间 字段说明:为预约上门开始时间,时间格式为 yyyy-mm-dd hh:mm:ss。contractor_phonestring否否否字段名称:承接商电话 字段说明:标准400电话或者是服务电话reception_timestring否否否字段名称:服务验收时间 字段说明:验收服务的具体时间点,时间格式为 yyyy-mm-dd hh:mm:ss。door_end_timestring否否否字段名称:预约上门结束时间 字段说明:为预约上门结束时间,时间格式为 yyyy-mm-dd hh:mm:ss。service_typestring是否否字段名称:服务规格 字段说明:纯文本信息payment_typestring是否否字段名称:付款类型 字段说明:枚举值:一口价price、预订booking、预定reservation 一口价:服务标的定价相对标准,浮动空间不大的,如保洁类、上门开锁等;即便后续有增项费用,也一般由服务人员和用户线下交易,平台不管控(主要缺少管控抓手) 预订:用户预先支付定金,服务人员上门后确定费用后开单,完成二次支付(一般是维修类)。如果二次报价用户不接受,可以取消订单。 预定:用户先提交意向,服务人员电话后确定涉及大致费用,线上支付定金,服务完成后进行二次支付(主要是搬家类)phonestring否否否字段名称:服务人员凯发k8官方网娱乐官方的联系方式 字段说明:虚拟号商品信息列表开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:参数类型是否必填能否更新是否消息使用字段参数说明item_namestring是否否商品名称。建议商品名称格式为:{商家名称} {商品名称}quantitynumber否否否商品数量。支持两位小数点。 注意:与unit_price成对出现,若传了quantity,则需要将unit_price传入unit_priceprice否否否商品单价。精确到小数点后两位。单位为元注意:与quantity成对出现,若传了unit_price,则需要将quantity传入unitstring否否否字段名称:商品规格 字段说明:服务类型,以下枚举值 家政保洁 家电清洗 软装清洗 管道疏通 家电维修 家具安装 上门开锁 上门搬家 ext_infoorderextinfo是否否商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。l ext_keystring是否否商品图片 key。固定为 image_material_id。l ext_valuestring是否否商品图片 value。需传入 上传商品文件 获取的 material_id。