完成接入准备后，商家/服务商可根据本文指引快速接入 订单中心。

说明：

订单中心 仅支持自研商家/服务商通过自研应用或第三方应用代调用方式，调用 API 接入。

订单中心 支持沙箱调试。

订单同步

接口调用流程图

接口调用注意事项

同步订单信息前，需要进行 订单服务用户授权，属于小程序端的调用，不耦合在同步订单信息时序图中。

当服务过程订单状态发生变更时，均需调用 alipay.merchant.order.sync(订单数据同步接口)完成相应的订单状态同步/更新。

当商家更新订单任何字段及状态时，需要把历史已同步的参数字段都再传入（等同于初次回传需要的参数）。

建议商家侧下单流程与订单同步流程用消息等方式进行解耦。

第一步：订单服务用户授权

支付宝客户端内获取

从用户隐私角度出发，商家只能回传用户授权后的订单数据。商家小程序需要在下单时弹出授权框，获取用户的授权后，订单才能回传到订单中心。

注意：

用户针对同一个小程序的同一类服务只需要授权一次。

如果涉及到不同安全等级的订单数据（如体检报告等），用户需要再次授权。

商家回传订单时，支付宝会判断商家是否获得用户授权，仅获得授权后才会执行后续流程。

scopes 说明

适用订单模板	scope	说明
未特别说明的均为此 scope	order_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 示例代码如下：

// 示例
my.getAuthCode({
  // 订单服务授权：order_service。如需同时获取用户多项授权，可在 scopes 中传入多个 scope 值。
  scopes: ['order_service'],
  success: (res) => {
    // 订单服务授权成功
  },
  fail: (res) => {
    // 订单服务授权失败，根据自己的业务场景来进行错误处理
  },
});

授权弹窗示例

支付宝客户端外获取

商家/服务商若拥有 App 应用，可通过支付宝端外授权 SDK 获取用户授权后同步订单数据。

获取授权 SDK

[极简版 SDK & Demo](https://opendocs.alipay.com/open-v3/05w8m5?pathHash=876c4870#客户端 Android 集成)

完整版 SDK & Demo

获取授权

根据接入 SDK 类型，商家/服务商可根据极简版 SDK 调用方法及完整版授权 SDK 调用方法接入支付宝端外授权功能。

注意：

app_id 为同步订单数据的小程序的 APPID。

scope 在订单中心场景需调整为对应行业场景。

适用订单模板	scope	说明
未特别说明的均为此 scope	order_service	订单服务授权，需要用户手动点击同意，表示用户同意《订单服务信息授权》。
汽车票、景区小交通、景区门票	trip_ticket
打车、顺风车	ride_hailing
充电桩、二轮充电桩	charging_pile
兼职招聘	ptjob_order_sync
代驾	indr_order_sync
租车	car_rental_auth
医疗行业	hospital_order
消费金融	consumer_finance

第二步：上传商品图片资料

开发者通过 alipay.merchant.item.file.upload（商品文件上传接口）上传图片，获取到对应的素材 ID（material_id）与素材标识（material_key）。

**说明：**同步订单信息时需传入商品图片内容，商家/服务商需提前上传商品图片信息至支付宝。

请求示例

重要入参说明

scene：场景码，固定为 SYNC_ORDER。

商品图片要求：

商品图片宽度必须大于 750 px，宽高比建议 4:3 - 1:1 之间，暂仅支持 jpg、png 格式，不支持其它格式。

仅支持本地资源路径，不支持在线图片地址。

响应示例

{
 "material_id":"2019010100502200000000000001",
 "material_key":"A*bJXMRYFoBcIAAAGGGGAAAABjAQWWWW"
}

重要响应说明

material_id：文件在商品中心的素材标识（素材ID长期有效），用于同步订单信息时作为商品图片，同 PID 下通用。

material_key：文件在商品中心的素材标示，创建/更新商品时使用，同 PID 下通用。

第三步：同步订单

开发者通过 alipay.merchant.order.sync（订单数据同步接口）同步配送订单商品、订单明细、订单状态信息，还可同步商家自发自核的优惠券、门店、取货码等内容。**
**

注意：

各行业接口出、入参不同，详情可查看 各行业同步详情。

本方案仅支持已上架小程序同步服务订单，如有支付行为可按照指引传入 trade_no 添加用户付款信息。

当商家/服务商更新订单任何字段及状态时，需要把历史已同步的参数字段都再传入（等同于初次回传需要的参数）。

第四步：订单实时信息查询

商家如需在用户支付宝客户端展示订单相关的实时信息时，可实现spi.alipay.merchant.order.realtimeinfo.query（商户订单实时信息查询）。支付宝将调用此接口，获取商家返回的（如：司机距离、位置等）订单实时信息进行展示。

**注意：**商家/服务商需根据不同行业场景要求决定是否需要接入本功能。详情可查看 实现订单实时信息查询接口详情。

开发接入

订单同步#

接口调用流程图#

接口调用注意事项#

第一步：订单服务用户授权#

支付宝客户端内获取#

scopes 说明#

接入示例#

授权弹窗示例#

支付宝客户端外获取#

获取授权 SDK#

获取授权#

第二步：上传商品图片资料#

请求示例#

响应示例#

第三步：同步订单#

第四步：订单实时信息查询#

订单同步

接口调用流程图

接口调用注意事项

第一步：订单服务用户授权

支付宝客户端内获取

scopes 说明

接入示例

授权弹窗示例

支付宝客户端外获取

获取授权 SDK

获取授权

第二步：上传商品图片资料

请求示例

响应示例

第三步：同步订单

第四步：订单实时信息查询