本地生活商品产品接入流程
产品版本介绍
产品使用流程
准备工作
发布小程序
开通交易组件
商家订购服务商模版小程序流程
服务商代开发模式开通交易组件
1.
2.
3.
app_auth_token（商家授权令牌）用于调用产品相关接口。4.
5.
本地生活商品插件订购及集成
订购“本地生活商品插件”
开放平台订购
1.
2.
服务商市场订购
集成“本地生活商品插件”
蚂蚁门店新增和管理
接口提报门店
蚂蚁门店店员维护
补充收款账号信息
类目申请指南
接入指南
本地生活商品接口开发接入
本地生活商品类目查询
本地生活商品模板查询接口
本地生活商品详细接口说明
| 模块 | 接口中文名 | 类型&调用流向 | 接口地址 |
|---|---|---|---|
| 商品创建 | 小程序本地商品创建接口 | 接口（开发者->支付宝） | alipay.open.app.localitem.create（小程序本地商品创建） |
| 商品管理 | 小程序本地商品修改接口 | 接口（开发者->支付宝） | alipay.open.app.localitem.modify（小程序本地商品修改接口） |
| 小程序本地商品 免审更新商品接口 | 接口（开发者->支付宝） | alipay.open.app.localitem.direct.modify（小程序本地商品免审更新商品接口） | |
| 小程序商品移除接口 | 接口（开发者->支付宝） | alipay.open.app.item.delete（小程序商品移除接口） | |
| 商品查询 | 获取本地商品类目接口 | 接口（开发者->支付宝） | alipay.open.app.localitem.allcategory.query（获取本地商品类目接口） |
| 获取本地商品模板信息接口 | 接口（开发者->支付宝） | alipay.open.app.localitem.template.query（获取本地商品模板信息） | |
| 小程序本地商品详情查询接口 | 接口（开发者->支付宝） | alipay.open.app.localitem.query（小程序本地商品详情查询接口） | |
| 商品状态 | 商品状态变更消息同步接口 | 消息（支付宝->开发者） | alipay.open.app.item.status.notify（商品状态变更消息同步接口） |
凭证核销开发接入
凭证核销详细接口说明
| 模块 | 接口中文名 | 类型&调用流向 | 接口地址 |
|---|---|---|---|
| 凭证核销 | 凭证核销准备 | 接口（开发者->支付宝） | alipay.marketing.certificate.certification.prepareuse（凭证核销准备） |
| 同步凭证核销状态 | 接口（开发者->支付宝） | alipay.marketing.certificate.certification.use（同步凭证核销状态） | |
| 撤销凭证核销状态 | 接口（开发者->支付宝） | alipay.marketing.certificate.certification.refund（撤销凭证核销状态） | |
| 凭证退款（核销前随时退和过期退前置咨询） | 退款前向商户确认是否可以退款 | 接口（支付宝->开发者） | spi.alipay.marketing.certificate.order.refundconfirm（退款前向商户确认是否可以退款） |
| 订单退款前商户回复确认退款结果 | 接口（开发者->支付宝） | alipay.marketing.certificate.order.refundconfirmcommit（订单退款前商户回复确认退款结果） | |
| 凭证状态查询 | 查询凭证信息 | 接口（开发者->支付宝） | alipay.marketing.certificate.certification.batchquery（查询凭证信息） |
| 小程序私域用户凭证查询 | 条件查询用户凭证 | 接口（开发者->支付宝） | alipay.marketing.certificate.user.batchquery（条件查询用户凭证） |
| 小程序私域核销准备 | 核销准备 JSAPI | 接口（开发者->支付宝） | my.ap.prepareUseCertificate（凭证核销准备）入参：certificateId出参可获得：encryptedCode |
本地生活商品插件开发接入
普通静态加载
// app.js
if (!my.canIUse('plugin') && !my.isIDE) {
my.ap && my.ap.updateAlipayClient && my.ap.updateAlipayClient(); // 如果动态加载不可用则打开支付宝客户端升级界面
}
App({
onLaunch() {},
onShow() {},
});app.json 配置
{
"plugins": {
"groupPurchaseoucherPlugin": {
"version": "*", // 目前只支持设置 * ，自动选择版本
"provider": "插件ID"
},
}
}页面配置
reLaunchAPI 进行跳转，这样才会有首页的 icon 的显示。（若使用 navigateTo Api只会有返回箭头 icon）my.reLaunch({
url: `plugin://groupPurchaseoucherPlugin/index?outItemId=${outItemId}`
// outItemId为外部商品id
});懒加载模式加载
兼容规则
app.json 配置
// 使用静态懒加载
{
"plugins": {
"groupPurchaseoucherPlugin": {
"lazy": true, // 开启懒加载模式
"version": "*", // 目前只支持设置 * ，自动选择版本
"provider": "2021003190661263"
}
},
// 配置懒加载插件预加载
"preloadRule": {
"pages/index/index": { // 这里路径为需要加载插件的本地小程序页面路径
"network": "all",
"plugins": ["groupPurchaseoucherPlugin"]
}
}
}页面配置
reLaunchAPI 进行跳转，这样才会有首页的 icon 的显示。（若使用 navigateTo Api 只会有返回箭头 icon）my.reLaunch({
url: `plugin://groupPurchaseoucherPlugin/index?outItemId=${outItemId}`
// outItemId为外部商品id
});动态加载
app.json配置
{
"useDynamicPlugins": true
}页面配置
reLaunchAPI 进行跳转，这样才会有首页的 icon 的显示。（若使用 navigateTo Api只会有返回箭头 icon）Page({
data: {
},
onLoad() {
},
navToPluginPage() {
// 跳转到插件页面，index为插件plugin.json中对外暴露的页面
my.reLaunch({
url: `dynamic-plugin://插件ID/index?outItemId=${outItemId}`
// outItemId为外部商品id
});
},
});公域到小程序插件地址
page 后的内容需要 URL 编码。alipays://platformapi/startapp?appId=宿主A&page=${encodeURIComponent(plugin-private://插件A/页面?outItemId=${outItemId})}alipays://platformapi/startapp?appId=宿主小程序appid&page=${encodeURIComponent(plugin-private://插件ID/pages/index/index?outItemId=${outItemId})}alipays://platformapi/startapp?appId=宿主小程序appid&page=${encodeURIComponent(plugin-private://插件ID/pages/orderdetail/orderdetail?orderId=${orderId})}开发环境联调说明（非必须流程）
1.
2.
首次进入插件处理登入逻辑
onLaunch 钩子里提供方法。 onShow 钩子里提供方法。App({
onLaunch() {
// 第一次打开
// options.query == {number:1}
// console.log(options);
// console.info('App onLaunch');
// 处理登入逻辑
},
onShow() {
// 从后台被 scheme 重新打开
// options.query == {number:1}
// console.log(options);
// 处理登入逻辑
},
});“去小程序使用”链接规则
alipays://platformapi/startapp?appId=[appId]&page=[page]&query=[query]
订单查询开发接入
| 模块 | 接口中文名 | 类型&调用流向 | 接口英文名 | 说明 |
|---|---|---|---|---|
| 订单结果 | 订单创建结果通知 | 消息（支付宝->开发者） | alipay.open.mini.order.changed | 用户支付后同步订单消息 |
| 订单查询 | 订单详情查询接口 | 接口（开发者->支付宝） | alipay.open.mini.order.query | 查询订单详情信息，用于小程序内展示订单状态 |
订单核销后退款开发接入
| 模块 | 接口中文名 | 类型&调用流向 | 接口英文名 |
|---|---|---|---|
| 订单退款（核销后） | 订单售后退款 | 接口（开发者->支付宝） | alipay.open.mini.order.refund |
常见问题
1.
2.
3.
修改于 2023-11-21 08:35:36