中国道 · 文档入口统一

SDK接口文档已升级为统一商户接入中心 / 标准开放文档

为了避免多个旧文档入口造成混淆,SDK接入、OpenAPI接口、回调说明、会员身份透传、售后退款、餐饮 quoteId 锁价流程,已统一合并到一个正式开发文档。

打开正式开发文档 查看SDK v2演示 测试模式说明
统一入口/openapi/index.html 是唯一正式接口文档首页,已包含SDK v2、会员身份透传、订单查询与售后退款说明。
餐饮锁价餐饮/券类下单必须先 quoteId 报价锁价,不能前端裸传金额。
自动跳转本页将在 3 秒后自动跳转到正式开发文档。

如果没有自动跳转,请点击“打开正式开发文档”。旧文档内容已归档备份。

统一产品接口与后台智能路由

对外原则:下游客户只接中国道标准产品接口,不按上游分别适配。电影票、票务、快递、打车、生活 H5 等同一业务产品保持统一请求字段、统一响应字段和统一订单状态。

后台智能路由:中国道根据商户授权、产品配置、上游可用性、成本价、城市/资源覆盖、接口健康状态和风控策略,在后台选择来一票、知行合一或后续其他上游。

标准产品标准入口可路由上游对外口径
电影票Movie / ZxhyCinema来一票、知行合一城市、影院、影片、场次、座位、报价、下单、查单字段保持统一。
票务ZxhyTicket知行合一,后续可扩展城市、航司/车次/票务资源、预订和查单走标准字段。
快递ZxhyExpress知行合一,后续可扩展寄件、收件、重量、价格、轨迹字段保持统一。

H5 产品入口:返回上游 H5 地址

H5 类产品不是由中国道重新制作页面。标准链路是:商户/SDK 请求中国道接口,中国道校验授权并服务端签名请求上游 endpointAccess,再把上游返回的 h5Url/url 返回给商户。

POST /openapi/v1/sdk/h5-access?merchantId=11
{
  "typeCode": "MeituanWaimai",
  "interfaceTypeCode": "mt_waimai_interface"
}

美团系支付确认走 payCallback,普通 H5 产品走 payNotify(channelOrderId)