更新时间：2024-10-23 18:08:20配置项检测工具收藏订阅更新我的文档设置接入检测（即可查看检测结果）若有未通过的接入检测项，接口将无法调通去登录返回文档完成 接入准备 后，商家/服务商可根据本文指引快速接入 订单中心。说明：●订单中心 仅支持自研商家/服务商通过 自研应用 或 第三方应用 代调用方式，调用 api 接入。●订单中心 支持 沙箱调试。订单同步接口调用流程图接口调用注意事项●同步订单信息前，需要进行 订单服务用户授权，属于小程序端的调用，不耦合在 同步订单信息 时序图中。●当服务过程订单状态发生变更时，均需调用 alipay.merchant.order.sync(订单数据同步接口)完成相应的订单状态同步/更新。●当商家更新订单任何字段及状态时，需要把历史已同步的参数字段都再传入（等同于初次回传需要的参数）。●建议商家侧下单流程与订单同步流程用消息等方式进行解耦。第一步：订单服务用户授权支付宝客户端内获取从用户隐私角度出发，商家只能回传用户授权后的订单数据。商家小程序需要在下单时弹出授权框，获取用户的授权后，订单才能回传到订单中心。注意：●用户针对同一个小程序的同一类服务只需要授权一次。●如果涉及到不同安全等级的订单数据（如体检报告等），用户需要再次授权。●商家回传订单时，支付宝会判断商家是否获得用户授权，仅获得授权后才会执行后续流程。scopes 说明适用订单模板scope说明未特别说明的均为此 scopeorder_service订单服务授权，需要用户手动点击同意，表示用户同意《订单服务信息授权》。汽车票、飞机票、景区小交通、景区门票trip_ticket打车、顺风车ride_hailing充电桩、二轮充电桩charging_pile兼职招聘ptjob_order_sync代驾indr_order_sync租车car_rental_auth医疗行业hospital_order消费金融consumer_finance接入示例通过调用 my.getauthcode 获取用户授权，在 success 回调中可以获取到 authcode，即表示授权成功。js 示例代码如下：授权弹窗示例支付宝客户端外获取商家/服务商 若拥有 app 应用，可通过支付宝端外授权 sdk 获取用户授权后同步订单数据。获取授权 sdk●●获取授权根据接入 sdk 类型，商家/服务商 可根据 及 接入支付宝端外授权功能。注意：●app_id 为同步订单数据的小程序的 appid。●scope 在订单中心场景需调整为对应行业场景。适用订单模板scope说明未特别说明的均为此 scopeorder_service订单服务授权，需要用户手动点击同意，表示用户同意《订单服务信息授权》。汽车票、景区小交通、景区门票trip_ticket打车、顺风车ride_hailing充电桩、二轮充电桩charging_pile兼职招聘ptjob_order_sync代驾indr_order_sync租车car_rental_auth医疗行业hospital_order消费金融consumer_finance第二步：上传商品图片资料开发者通过 上传图片，获取到对应的素材 id（material_id）与素材标识（material_key）。说明：同步订单信息时需传入商品图片内容，商家/服务商 需提前上传商品图片信息至支付宝。请求示例重要入参说明●scene：场景码，固定为 sync_order。●商品图片要求：○商品图片宽度必须大于 750 px，宽高比建议 4:3 - 1:1 之间，暂仅支持 jpg、png 格式，不支持其它格式。○仅支持本地资源路径，不支持在线图片地址。响应示例重要响应说明●material_id：文件在商品中心的素材标识（素材id长期有效），用于同步订单信息时作为商品图片，同 pid 下通用。●material_key：文件在商品中心的素材标示，创建/更新商品时使用，同 pid 下通用。第三步：同步订单开发者通过 alipay.merchant.order.sync（订单数据同步接口）同步配送订单商品、订单明细、订单状态信息，还可同步商家自发自核的优惠券、门店、取货码等内容。注意：●各行业接口出、入参不同，详情可查看 各行业同步详情。●本方案仅支持已上架小程序同步服务订单，如有支付行为可按照指引传入 trade_no 添加用户付款信息。●当商家/服务商 更新订单任何字段及状态时，需要把历史已同步的参数字段都再传入（等同于初次回传需要的参数）。扫码点餐场景电商实物商品购买场景停车场景第四步：订单实时信息查询商家如需在用户支付宝客户端展示订单相关的实时信息时，可实现。支付宝将调用此接口，获取商家返回的（如：司机距离、位置等）订单实时信息进行展示。注意：商家/服务商可在 中 【实现订单实时信息查询】 章节，查询该功能的使用方法；部分行业订单模版暂不支持放订单实时查询能力，请以行业订单模版中提供的功能为准。
