开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
小程序产品
权限集列表
搜索关键词
搜索直达
收藏
消息
小程序码
小程序服务
订单中心
接入指南
各行业订单同步/查询详情
餐饮
零售批发
商业生活
交通出行
车主生活
教育培训
医疗卫生
酒旅景区
生活缴费
公共管理和社会组织
休闲娱乐
物流运输
网络通讯
api 列表
相关资料
小程序开发管理
生物核身
交易组件
小程序商品
支付有礼
商家粉丝群
营销产品
资金产品
会员产品
信用产品
广告产品
开发 > 服务端 > 私域产品 > 小程序产品 > 权限集列表 > 订单中心 >  >  >  > 充电桩(charging_pile)
收藏
订阅更新
我的文档
设置
接入检测
即可查看检测结果)
若有未通过的接入检测项,接口将无法调通
商家需通过 alipay.merchant.order.sync(订单数据同步接口) 订单扩展字段 ext_info#merchant_order_status 参数更新订单状态,充电桩专用状态如下。
订单状态流转说明
订单状态流转图
说明:左侧表示起始状态,右侧表示允许的后置状态。
充电桩.png

订单状态说明
支持跨状态传递,如:create(启动充电)可直接跳转至 fault(充电故障)。
不要求首次同步订单状态必须为 create(启动充电)。
当前场景定义的订单状态(中文和英文名)如下:
注意:不同订单状态,仅 是否发送服务消息 时,用户才能在 消息列表(支付宝凯发k8官方网娱乐官方首页服务提醒入口进入或凯发k8官方网娱乐官方首页底部消息 tab 进入)查看服务订单消息提醒。
状态中文名
状态英文名
是否发送服务消息
启动充电
create

充电中
serving

充电完成
finished

待支付
wait_pay

支付成功
paid

免费停车到期
free_due

即将收取占位费
to_take_charge

充电故障
fault

不同状态参数使用说明
商家需通过 alipay.merchant.order.sync(订单数据同步接口) 订单扩展字段 ext_info#merchant_order_status 参数更新订单状态,具体状态说明如下。
启动充电 (create)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-启动充电 (create)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

order_type
string



订单类型。固定为 service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号 trade_no 或 pay_amount 为必传时须传入amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list 时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status。
l ext_value
string



订单状态,例:create
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为:charging_pile。
l ext_key
string



订单详情地址 key。固定为 merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
charging_start_time
string



字段名称:充电开始时间。 字段说明:充电开始,拔充电枪的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_plan
string



字段名称:充电进度(百分比)。 字段说明:充电进度百分比(0-100)。若无,则不传;每一分钟读取一次,0-100 的数字。
charging_end_time
string



字段名称:充电结束时间。 字段说明:充电结束的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_time
string



字段名称:充电时长。 字段说明:充电结束后的,充电总时长,单位分,数字表达。
charging_station
string



字段名称:充电站名称 字段说明:充电站 poi 名称。
provider_name
string



字段名称:服务提供方 字段说明:服务提供方名称。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



商品数量。支持两位小数点。
注意:与 unit_price 成对出现,若传了 quantity,则需要将 unit_price传入。
unit_price
price



商品单价。精确到小数点后两位。单位为
注意:与 quantity 成对出现,若传了 unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
充电中 (serving)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-充电中 (serving)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号 trade_no 或 pay_amount 为必传时须传入 amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list 时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status。
l ext_value
string



订单状态,例:serving
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为:charging_pile。
l ext_key
string



订单详情地址 key。固定为 merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
charging_start_time
string



字段名称:充电开始时间。 字段说明:充电开始,拔充电枪的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_plan
string



字段名称:充电进度(百分比)。 字段说明:充电进度百分比(0-100)。若无,则不传;每一分钟读取一次,0-100 的数字。
charging_end_time
string



字段名称:充电结束时间。 字段说明:充电结束的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_time
string



字段名称:充电时长。 字段说明:充电结束后的,充电总时长,单位分,数字表达。
charging_station
string



字段名称:充电站名称 字段说明:充电站 poi 名称。
provider_name
string



字段名称:服务提供方 字段说明:服务提供方名称。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



商品数量。支持两位小数点。
注意:与 unit_price 成对出现,若传了 quantity,则需要将 unit_price传入。
unit_price
price



商品单价。精确到小数点后两位。单位为
注意:与 quantity 成对出现,若传了 unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
充电完成 (finished)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-充电完成 (finished)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号 trade_no 或 pay_amount 为必传时须传入 amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list 时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status。
l ext_value
string



订单状态,例:finished
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为:charging_pile。
l ext_key
string



订单详情地址 key。固定为 merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
charging_start_time
string



字段名称:充电开始时间。 字段说明:充电开始,拔充电枪的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_plan
string



字段名称:充电进度(百分比)。 字段说明:充电进度百分比(0-100)。若无,则不传;每一分钟读取一次,0-100 的数字。
charging_end_time
string



字段名称:充电结束时间。 字段说明:充电结束的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_time
string



字段名称:充电时长。 字段说明:充电结束后的,充电总时长,单位分,数字表达。
charging_station
string



字段名称:充电站名称 字段说明:充电站 poi 名称。
provider_name
string



字段名称:服务提供方 字段说明:服务提供方名称。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



商品数量。支持两位小数点。
注意:与 unit_price 成对出现,若传了 quantity,则需要将 unit_price传入。
unit_price
price



商品单价。精确到小数点后两位。单位为
注意:与 quantity 成对出现,若传了 unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
待支付 (wait_pay)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-待支付 (wait_pay)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号 trade_no 或 pay_amount 为必传时须传入 amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list 时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status。
l ext_value
string



订单状态,例:wait_pay
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为:charging_pile。
l ext_key
string



订单详情地址 key。固定为 merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
charging_start_time
string



字段名称:充电开始时间。 字段说明:充电开始,拔充电枪的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_plan
string



字段名称:充电进度(百分比)。 字段说明:充电进度百分比(0-100)。若无,则不传;每一分钟读取一次,0-100 的数字。
charging_end_time
string



字段名称:充电结束时间。 字段说明:充电结束的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_time
string



字段名称:充电时长。 字段说明:充电结束后的,充电总时长,单位分,数字表达。
charging_station
string



字段名称:充电站名称 字段说明:充电站 poi 名称。
provider_name
string



字段名称:服务提供方 字段说明:服务提供方名称。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



商品数量。支持两位小数点。
注意:与 unit_price 成对出现,若传了 quantity,则需要将 unit_price传入。
unit_price
price



商品单价。精确到小数点后两位。单位为
注意:与 quantity 成对出现,若传了 unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
支付成功 (paid)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-支付成功 (paid)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号 trade_no 或 pay_amount 为必传时须传入 amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list 时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status。
l ext_value
string



订单状态,例:paid
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为:charging_pile。
l ext_key
string



订单详情地址 key。固定为 merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
charging_start_time
string



字段名称:充电开始时间。 字段说明:充电开始,拔充电枪的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_plan
string



字段名称:充电进度(百分比)。 字段说明:充电进度百分比(0-100)。若无,则不传;每一分钟读取一次,0-100 的数字。
charging_end_time
string



字段名称:充电结束时间。 字段说明:充电结束的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_time
string



字段名称:充电时长。 字段说明:充电结束后的,充电总时长,单位分,数字表达。
charging_station
string



字段名称:充电站名称 字段说明:充电站 poi 名称。
provider_name
string



字段名称:服务提供方 字段说明:服务提供方名称。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



商品数量。支持两位小数点。
注意:与 unit_price 成对出现,若传了 quantity,则需要将 unit_price传入。
unit_price
price



商品单价。精确到小数点后两位。单位为
注意:与 quantity 成对出现,若传了 unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
免费停车到期 (free_due)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-免费停车到期 (free_due)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号 trade_no 或 pay_amount 为必传时须传入 amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list 时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status。
l ext_value
string



订单状态,例:free_due
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为:charging_pile。
l ext_key
string



订单详情地址 key。固定为 merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
charging_start_time
string



字段名称:充电开始时间。 字段说明:充电开始,拔充电枪的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_plan
string



字段名称:充电进度(百分比)。 字段说明:充电进度百分比(0-100)。若无,则不传;每一分钟读取一次,0-100 的数字。
charging_end_time
string



字段名称:充电结束时间。 字段说明:充电结束的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_time
string



字段名称:充电时长。 字段说明:充电结束后的,充电总时长,单位分,数字表达。
fault_cause
string



字段名称:故障原因。
字段说明:充电异常原因。
free_rule
string



字段名称:收费规则。
字段说明:文本表达,预估可能出现的停车收费规则。
charging_station
string



字段名称:充电站名称。
字段说明:充电站 poi 名称。
provider_name
string



字段名称:服务提供方。
字段说明:服务提供方名称。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



商品数量。支持两位小数点。
注意:与 unit_price 成对出现,若传了 quantity,则需要将 unit_price传入。
unit_price
price



商品单价。精确到小数点后两位。单位为
注意:与 quantity 成对出现,若传了 unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
即将收取占位费 (to_take_charge)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-即将收取占位费 (to_take_charge)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入 (当支付宝交易号 trade_no 或 pay_amount 为必传时须传入 amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list 时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status。
l ext_value
string



订单状态,例:to_take_charge
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为:charging_pile。
l ext_key
string



订单详情地址 key。固定为 merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
charging_start_time
string



字段名称:充电开始时间。 字段说明:充电开始,拔充电枪的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_plan
string



字段名称:充电进度(百分比)。 字段说明:充电进度百分比(0-100)。若无,则不传。每一分钟读取一次,0-100 的数字。
charging_end_time
string



字段名称:充电结束时间。 字段说明:充电结束的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_time
string



字段名称:充电时长。 字段说明:充电结束后的,充电总时长,单位分,数字表达。
fault_cause
string



字段名称:故障原因。 字段说明:充电异常原因。
free_rule
string



字段名称:收费规则。 字段说明:文本表达,预估可能出现的停车收费规则。
charging_station
string



字段名称:充电站名称。 字段说明:充电站 poi 名称。
provider_name
string



字段名称:服务提供方。 字段说明:服务提供方名称。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



商品数量。支持两位小数点。
注意:与 unit_price 成对出现,若传了 quantity,则需要将 unit_price传入。
unit_price
price



商品单价。精确到小数点后两位。单位为
注意:与 quantity 成对出现,若传了 unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。
充电故障 (fault)
本文详细介绍通过接口 alipay.merchant.order.sync 同步订单状态-充电故障 (fault)时需传入的商品信息及扩展字段参数信息。
接口参数 bizcontent 示例
参数说明
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
out_biz_no
string



外部订单号。由商家自定义。
注意:同一笔订单更新状态时,需与首次同步入参一致。
buyer_id(buyer_open_id)
string



支付宝用户唯一标识。新商户建议使用open_id替代该字段。对于新商户,user_id字段未来计划逐步回收,存量商户可继续使用。如使用open_id,请确认 应用-开发配置-openid配置管理 已启用。无该配置项,可查看 

order_type
string



订单类型。固定为service_order(服务订单)。
order_create_time
string



订单创建时间,即该笔订单真实的创建时间。时间格式为 yyyy-mm-dd hh:mm:ss。
order_modified_time
string



订单修改时间,时间格式为 yyyy-mm-dd hh:mm:ss.sss。用于订单状态或数据变化较快的顺序控制,防止乱序。order_modified_time 较晚的同步会被最终存储,order_modified_time 相同的两次同步会被幂等处理。
source_app
string



订单来源,默认alipay(支付宝小程序),钉钉来源dingtalk,其它来源枚举值定义联系支付宝订单中心添加。
item_order_list
itemorderinfo



商品信息列表。详情可查看下文 商品信息列表
ext_info
orderextinfo



订单扩展字段。详情可查看下文 订单扩展字段
trade_no
string



支付宝交易号。 此字段关联支付宝账单详情卡片,建议回传真实有效交易号。
amount
price
选填,建议传入(当支付宝交易号 trade_no 或 pay_amount 为必传时须传入 amount)


订单总金额。精确到小数点后两位,单位为
pay_amount
price
选填,建议传入该参数


实际支付金额。精确到小数点后两位。单位为
discount_amount
price



优惠金额。传入 discount_info_list 时必填。单位为
订单扩展字段
开发者需通过订单扩展字段(ext_info)更新订单状态,订单业务信息,订单类型等数据,入参为 ext_key(对应参数的key)、ext_value(对应参数的value) 配合使用。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
l ext_key
string



订单状态 key。固定为 merchant_order_status。
l ext_value
string



订单状态,例:fault
l ext_key
string



订单类型 key。固定为 merchant_biz_type。
l ext_value
string



订单类型 value。本业务场景为:charging_pile。
l ext_key
string



订单详情地址 key。固定为 merchant_order_link_page。
l ext_value
string



商家小程序对应的订单详情页路径地址 value。仅需传入小程序页面路径即可。同一笔订单的链接必须与第一次传入的地址相同,且需是小程序内部页面路径,例如:/pages/index/index?orderid=10190608609185
l ext_key
string



商家小程序 appid key。固定为 tiny_app_id。
l ext_value
string



商家小程序 appid value。传入订单归属的小程序 appid。
l ext_key
string



订单业务场景相关的信息 key。固定为 business_info。
l ext_value
jsonstring



订单业务信息详情 value。入参详情见下文 业务信息参数
业务信息参数
业务信息参数(business_info) 的各项入参详情如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
charging_plan
string



字段名称:充电进度(百分比)。 字段说明:充电进度百分比(0-100)。若无,则不传。每一分钟读取一次,0-100 的数字。
charging_start_time
string



字段名称:充电开始时间。 字段说明:充电开始,拔充电枪的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_end_time
string



字段名称:充电结束时间。 字段说明:充电结束的时间点,时间格式为 yyyy-mm-dd hh:mm:ss。
charging_time
string



字段名称:充电时长。 字段说明:充电结束后的,充电总时长,单位 ,数字表达。
fault_cause
string



字段名称:故障原因。 字段说明:充电异常原因。
free_rule
string



字段名称:收费规则。 字段说明:文本表达,预估可能出现的停车收费规则。
charging_station
string



字段名称:充电站名称。 字段说明:充电站 poi 名称。
provider_name
string



字段名称:服务提供方。 字段说明:服务提供方名称。
商品信息列表
开发者需通过商品信息列表字段(item_order_list)传入商品图片、商品详情页等信息。参数说明如下:
参数
类型
是否必填
能否更新
是否消息使用字段
参数说明
item_name
string



商品名称。建议商品名称格式为:{商家名称} {商品名称}
quantity
number



商品数量。支持两位小数点。
注意:与 unit_price 成对出现,若传了 quantity,则需要将 unit_price传入。
unit_price
price



商品单价。精确到小数点后两位。单位为
注意:与 quantity 成对出现,若传了 unit_price,则需要将 quantity 传入。
ext_info
orderextinfo



商品扩展参数。该参数用于传入用户购买商品图片及商家商品详情页地址等信息。
l ext_key
string



商品图片 key。固定为 image_material_id。
l ext_value
string



商品图片 value。需传入 上传商品文件 获取的 material_id。