• 下载
  • 社区

小程序订单中心

产品介绍

产品概述


小程序订单中心是面向 C 端用户提供的小程序交易服务产品,用户在小程序内下单支付,商户回传订单信息后,可通过订单中心小程序查看消费明细及快速联系商家咨询售后相关问题;完成交易后,用户还可对此次消费体验进行评价打分。


产品特色


订单中心在为用户提供交易服务的同时,也为商家的小程序提供了流量入口,提高用户的活跃度和留存率。用户可快速进入商家的小程序及对应的商品详情页,商家可利用此入口来提升会员复购率或给予会员权益。

用户访问入口

订单中心入口


用户在小程序内支付成功后,可在支付宝客户端选择 我的 > 账单 进入账单详情页上的入口跳转到订单中心小程序查看订单详情页,如下图所示。


订单中心.png


如下图所示,用户在“订单中心”中有两种方式进入商家的小程序首页:列表页和详情页;在详情页,用户还可以通过点击 查看订单明细 查看订单详情。


商家权益


商家回传订单信息后,小程序平台会根据小程序的 UV(独立访客数量) 和订单、服务质量等因素来综合评估给予以下权益。


注意:

以下权益目前采用定向机制,暂不支持主动申请,商家在回传订单信息时请参考下文的《订单明细同步规范》。


搜索运营


商家同步订单信息后,符合搜索运营准入条件的,可在小程序管理后台 运营中心 > 搜索开放 > 搜索运营 页面申请搜索服务,具体准入条件及配置方式,请点击查看小程序搜索服务

商户同步的商品信息可作为小程序搜索关键词,用户搜索商品名称/服务名称即可找到商家的小程序。

其他权益(待开放)


后续会陆续开放更多权益给到商户,敬请期待!


准入条件


商家需满足以下条件,用户在小程序内支付成功后,可在订单中心中查看订单:

  1. 商家需接入“小程序支付”产品;
  2. 商家需在用户支付成功后,通过接口同步此笔交易明细(商品图片、商品名称、订单详情 URL 等)。


注意:

目前小程序订单中心暂不支持代扣订单接入。


计费模式

免费


接入指引

第一步:创建小程序


要在您的小程序内使用订单中心功能,您需要首先完成开发者入驻创建小程序

第二步:添加功能

小程序创建完成后,开发者在 功能列表 部分可以点击 添加功能 来添加 小程序订单中心 功能。勾选相应功能后,点击 确定 即可添加功能。


第三步:签约功能


小程序订单中心 功能需要签约才能生效,开发者添加功能后,点击功能列表右侧 签约,提交相关信息;完成签约后,需要一个工作日左右的审核时间(审批结果会以短信和邮件形式告知),待审核完毕后,功能的状态会变成“已生效”,即可使用 小程序订单中心 功能。

image.png

第四步:集成并配置 SDK


服务端 SDK 需要商户集成在自己的服务端系统中,用于后续的服务端接口调用。

下载服务端 SDK

为了帮助开发者调用开放接口,我们提供了开放平台服务端 SDK,包含 JAVA、PHP、NodeJS、Python 和 .NET 五种语言,封装了签名 & 验签、HTTP 接口请求等基础功能。请先下载对应语言版本的 SDK 并引入您的开发工程。

接口调用配置

在 SDK 调用前需要进行初始化,以 JAVA 代码为例:

AlipayClient alipayClient = new DefaultAlipayClient(URL,APP_ID,APP_PRIVATE_KEY,FORMAT,CHARSET,ALIPAY_PUBLIC_KEY,SIGN_TYPE);

关键参数说明:

配置参数示例值解释获取方式/示例值
URL支付宝网关(固定) https://openapi.alipay.com/gateway.do 
APPIDAPPID 即创建应用后生成获取见创建应用
APP_PRIVATE_KEY开发者私钥,由开发者自己生成获取见配置密钥
FORMAT参数返回格式,只支持 jsonjson(固定)
CHARSET编码集,支持 GBK/UTF-8开发者根据实际工程编码配置
ALIPAY_PUBLIC_KEY支付宝公钥,由支付宝生成获取详见配置密钥
SIGN_TYPE商户生成签名字符串所使用的签名算法类型,目前支持 RSA2 和 RSA,推荐使用 RSA2RSA2

接下来,就可以用 alipayClient 来调用具体的 API 了。alipayClient 只需要初始化一次,后续调用不同的 API 都可以使用同一个 alipayClient 对象。


注意:

ISV /开发者可以通过第三方应用授权得到商户授权令牌(app_auth_token)作为请求参数传入,实现代商户发起请求的能力。

第五步:调用接口


小程序订单中心的接口调用顺序如下图所示:

注意:

需在订单同步需传入素材 ID、商品名称、订单详情 URL,否则订单中心将不展示此笔订单。


上传商品文件

开发者通过 alipay.merchant.item.file.upload 接口上传图片,获取到对应的素材 id。

订单信息同步

开发者通过 alipay.merchant.order.sync 接口,将商品(包含素材 id)、订单状态、跳转链接等信息,通过交易号同步到支付宝。同步订单数据的要求请参见下文的《订单明细同步规范》


注意:

目前小程序订单中心暂不支持代扣功能接入。若商家接入的不是小程序支付产品,而是使用代扣功能,回传参数时系统会报出“小程序 id 为空”的错误信息。


调用接口的请求代码示例如下:


{
  "out_biz_no": "1234",
  "amount": 12.34,
  "buyer_id": "2088102165400195",
  "seller_id": "2088301176313427",
  "partner_id": "2088301176313427",
  "trade_no": "2019052322001400191000023731",
  "item_order_list": [
    {
      "item_name": "苹果",
      "quantity": 1,
      "unit_price": 12.34,
      "ext_info": [
        {
          "ext_key": "image_material_id",
          "ext_value": "2019061700502200000017592474"
        }
      ]
    }
  ],
  "ext_info": [
    {
      "ext_key": "merchant_order_status",
      "ext_value": "MERCHANT_CONFIRMED"
    },
    {
      "ext_key": "merchant_order_link_page",
      "ext_value": "/pages/order-detail/order-detail?id=1234"
    }
  ]
}


注意:

针对订单同步接口 alipay.merchant.order.sync,需要在主扩展字段和商品扩展字段填入如下参数。


1.主扩展字段包括 商户小程序跳转信息 和 商户侧订单状态。

商户小程序跳转信息 只允许传入 1 次,不允许覆盖。


参数名称

传参说明

ext_info# merchant_order_link_page 

跳转到商户小程序对应的订单详情页链接地址; ext_value 参数请传入 page 后面的值。


商户侧订单状态必须满足以下流转状态机,如果交易在支付宝测已退款关闭,则不允许再同步商户侧订单状态。


参数名称

传参说明

ext_info# merchant_order_status 

需要满足以下跳转状态:

商户状态

MERCHANT_CONFIRMED:商家已确认。

MERCHENT_SERVICING:商家发货中。

MERCHANT_DELIVERD:订单已配送。

MERCHANT_FINISHED:订单已完成


2.商品信息 item_order_list 可以多次同步覆盖,商品扩展字段 ext_info,本次必须传入素材 id;如果同步了商品信息,商品扩展字段必须传入素材 id。


参数名称


传参说明

ext_info# image_material_id

素材 id

存储在 itemcore 数据库中

订单明细同步规范

订单相关


  • 在首次接入时,开发者需导入最近三个月的”历史订单“数据,导入数据有助于用户查看历史订单数据,同时后续商品可在搜索中获得更多小程序曝光机会
  • 开发者可以在用户支付完成后,实时同步小程序的交易订单明细,便于用户后续查看交易明细及进度情况
  • 导入订单必须为用户在小程序内下单支付的订单且回传订单信息包含商品图片、商品名称、订单详情url,否则在订单中心列表页不会展示(系统会自动识别交易来源是否为小程序)
  • 导入订单明细时,须按支付宝交易号来进行导入数据,订单内的商品信息可更新维护(建议不要多次更新,避免订单内的商品变更对用户体验带来的影响),跳转详情页的参数不允许再次更新,请确保数据准确性再同步

商品相关


  • 在同步订单明细时,须完整回传该笔交易中用户购买的所有商品明细
  • 商品图片宽度必须大于 750 px,宽高比建议 4:3 - 1:1 之间
  • 商品名称建议按以下规范来组合回传
    • 电商行业:和小程序内展示的商品名称保持一致
    • 其他行业:若无合适的商品名称,建议可按一些特征来生成商品名称,如:共享充电宝类,商品名称:“租借地点:利星行汽车中心”

跳转参数


开发者可同步订单详情页的页面地址,用户点击后进入小程序查看交易进度等信息,参数规范如下:

  • 开发者只需在“path”中入参页面地址,系统会自动根据该笔交易对应的 APPID 来拼接跳转链接
  • 用户点击进入小程序时,系统会自动传递访问来源,商户可根据访问来源做一些业务逻辑处理,比如:给通过此渠道过来的复访用户发优惠券;访问来源参数:chInfo=ch_orderCenter
  • 跳转参数同步后不允许更改,请确保数据准确性再同步


API 列表


此列表包含该产品所涉及的所有接口,点击接口英文名可查看接口的公共请求参数,业务请求参数,返回参数,其他语言请求示例以及错误码等。

接口英文名

接口中文名

alipay.open.auth.token.app 

换取应用授权令牌

alipay.merchant.item.file.upload

商品文件上传接口

alipay.merchant.order.sync

订单数据同步接口