文档

小程序配置

更新时间:

产品绑定与能力开通

支付宝为小程序提供多种如支付、私域、会员等类别的产品能力,需要通过绑定产品,使小程序具备对应产品能力。

说明

部分产品能力需要单独开通。

支付宝开放平台小程序控制台开发>产品绑定界面,单击绑定产品,输入产品名称进行搜索,勾选产品后单击确定绑定产品。

说明
  • 部分产品需要开通后才能使用。

  • 请至少选择一个产品。

image.png

当面付

  1. 在搜索框输入当面付,勾选产品后单击确定

  2. 产品添加完成后,单击去开通,申请并开通此产品能力。image.png

获取会员基础信息

在搜索框输入会员基础信息,勾选产品后单击确定

获取会员手机

  1. 在搜索框输入获取会员手机号,勾选产品后单击确定。

  2. 产品添加完成后,若未申请,单击用户信息申请来获取权限。image.png

  3. 用户信息申请:获取会员手机号界面,单击申请权限,根据界面要求填写申请信息。image.png

    填写信息时,需要上传场景demo图,场景demo图可参考下图,商家可通过修改下图中的小程序名与Logo、商品相关信息等后上传demo图。image.png

    说明

    原图可向运营小二索取:会员手机号能力获取demo。

获取会员信息

在搜索框输入获取会员信息,勾选产品后单击确定。

获取会员收获地址

说明

因此产品开通需人工审核,存在提审被驳回的可能,请关注审核结果;如被驳回,请按照驳回理由修改后重新提交审核。

  1. 在搜索框输入收获地址,勾选产品后单击确定

  2. 产品添加完成后,单击申请使用申请此产品能力,根据界面要求填写申请信息。image.png

    填写信息时,需要上传场景demo图,场景demo图可参考下图,商家可通过修改下图中的小程序名与Logo、商品相关信息等后上传demo图。image.png

    说明

    原图可向运营小二索取:会员收货地址能力获取demo。

小程序码(原小程序二维码)

在搜索框输入小程序,搜索小程序权限集,勾选产品,单击修改,在跳转的当前产品所包含权限集界面勾选小程序码产品,单击确定。image.pngimage.png

小程序端基础产品(原小程序基础包(企业开发者版))

在搜索框输入小程序端基础产品,勾选产品后单击确定

商家券

商家券能力需要绑定开通商家券并需要配置消息订阅。

  1. 绑定商家券产品并开通

    在搜索框输入商家券,勾选产品后单击确定

  2. 订阅消息

    说明

    消息订阅必须开启后才能正常创建商家券。

    完成绑定商家券产品后,在开发 > 开发设置 > 消息服务界面中会出现一些API列表,右侧的订阅需要全部勾选开通,接入方式选择WebSocket。image.png

消息盒子

  1. 基础设置 > 小程序信息 > 基础设置界面,开启允许小程序互相跳转,一般默认为已允许。image.png

  2. 在搜索框输入小程序,勾选产品,单击修改,在跳转的当前产品所包含权限集界面勾选订单中心,单击确定。image.pngimage.png

  3. 产品绑定界面,找到小程序,单击下方展开,在展开的权限集界面中找到订单中心,单击右侧image.png去开通。image.pngimage.png

  4. 权限集列表下,找到订单中心,单击右侧开通image.png

  5. 订单中心界面单击提交。经营信息为系统默认信息,无需编辑。image.png

审核通过后,在产品绑定小程序展开界面,订单中心权限集开通状态显示为已开通image.png

私域营销

在搜索框输入基础功能产品,勾选产品,单击修改,在跳转的当前产品所包含权限集界面勾选私域营销,单击确定。image.pngimage.png

产品绑定界面,找到基础功能产品,单击下方查看,在当前产品已绑定的权限集界面查看私域营销权限集开通状态显示为已开通image.png

领券组件插件

  1. 进入支付宝开放平台,在开发>插件服务界面,单击订购其他插件image.png

  2. 发现插件搜索框输入领券组件并搜索,单击领券组件插件进入该组件详情页。image.png

  3. 单击立即获取获取对应组件。image.png

  4. 选择需要绑定的小程序,勾选同意协议后单击授权并绑定image.png

开发>插件服务>插件管理列表中,可查看已绑定的插件。image.png

商家会员卡

  1. 在搜索框输入商家会员卡,勾选产品后单击确定

  2. 申请用户信息。

    1. 产品绑定界面,单击商家会员卡右侧用户信息申请,在提示框中单击继续申请商家会员卡

      说明
      • 若商家在注册支付宝小程序时未填写主营行业,需要先完善主营行业信息。在基础设置 > 小程序信息界面,选择主营行业

      • 不同的主营行业,所能申请的用户信息会有所差异。

      image.png

    2. 主营行业设置完成并审核通过后,申请用户信息列表中的各项权限,单击申请权限进入申请页面。

      重要

      手机号码必须申请,其余权限按需申请。

      image.png

    3. 按要求填入各项信息,提交申请并等待审核。

      说明

      demo图可向阿里云运营小二索取后自行替换小程序名等信息。

      申请完成后,等待支付宝审核通过,请商家关注审核结果。

  3. 订阅会员卡开卡通知。

    开发>开发设置>消息服务界面,订阅会员卡开卡结果通知消息,接入方式选择WebSocketimage.png

  4. 上线商家会员卡API。

    1. API管理 > 实现官方标准API界面,单击商家会员卡右侧去开发

    2. 在跳转的官方定义的标准API列表(SPI)界面,单击会员卡开通,获取会员卡信息右侧接入

    3. 填写服务配置基础后单击保存&下一步

      • 后端服务正式地址:商家配置的三级域名+/v1/alipay/spi/isv/service,如

        https://***.ddmall.***.com/v1/alipay/spi/isv/service

      • 后端服务测试地址:商家配置的三级域名+/v1/alipay/spi/isv/service,如

        https://***.ddmall.***.com/v1/alipay/spi/isv/service

        说明

        如何配置和解析三级域名,请参考独立域名配置

      • 响应是否加签:是

      • 请求编码:UTF-8

    4. 单击发布,在提示框中单击确定后,状态更新为开发中image.png

    5. 单击接口右侧详情,单击服务基础配置下方确定,此时最新版本/状态更新为已接入

      image.png

    6. 单击左上角申请上线。申请后,状态变更为上线审核中,等待审核。审核结束后,状态更新为已上线image.png

  5. 订购支付宝卡包插件。

    1. 开发>插件服务界面,单击订购其他插件

    2. 发现插件搜索框输入支付宝卡包并搜索,单击支付宝卡包插件进入该插件详情页。

    3. 单击立即获取,获取后,可在插件服务列表中显示该插件。

  6. openURL配置。

    说明

    需要先完成支付宝卡包插件的订购,否则开发设置中无openURL配置入口。

    1. 开发设置>openURL配置界面,单击右侧添加

    2. 填写申请表中的信息,单击申请。可参考下方示例填写。

      1. 添加地址:alipays://platformapi/startapp?appId=20000021

      2. 业务场景:小程序内部跳转到商家会员卡详情页

      3. 上产实例:上传会员卡详情页截图

      4. 申请原因:小程序内部跳转到商家会员卡详情页,提示需要加白

    3. 申请通过后,配置列表中的申请状态将更新为通过image.png

红海组件

  1. 订购商品详情组件插件

    1. 登录支付宝商家平台,在运营中心>服务市场>服务市场首页界面,单击立即订购订购商品详情组件插件

    2. 选择需要添加的小程序,输入联系人信息,勾选授权规则后单击授权并订购,根据界面提示完成订购image.png

  2. 开通交易组件

    1. 登录支付宝商家平台,在运营中心>小程序界面,单击需要开通组件的小程序。

    2. 在跳转的小程序数据界面单击左侧最下方交易组件,单击申请开通image.png

    3. 在跳转的申请开通界面,单击签约JSAPI支付右侧去签约,开始签约JSAPI支付。

    4. 核对信息后勾选同意服务协议,单击申请开通

    5. 提交后,等待审核。

      审核通过后,签约JSAPI支付状态更新为签约成功image.png

  3. 订阅消息服务

    1. 登录支付宝开放平台,在控制台>开发>开发设置>消息服务界面,单击右侧订阅订阅订单结果通知image.png

    2. 选择连接方式WebSocket,单击确定订阅,订阅完成后可在消息服务界面查看订单结果通知状态显示为已订阅image.png

私域兑换组件

私域兑换组件需支付宝会员频道积分兑换活动配合,建议商家完后活动报名后再配置该组件。

组件详细操作请参见支付宝小程序-私域兑换组件功能配置指引

商城小程序基础配置

  1. 登录阿里云LinkedMall品牌商城运营控制台,在多端>小程序>支付宝小程序界面,单击授权已有小程序

  2. 填写支付宝小程序店铺品牌全称店铺品牌简称appID等内容,单击点击上传上传小程序Logo。小程序Logo图片大小不超过2MB,分辨率为600×600px。

    支付宝公钥应用私钥获取请参考填入密钥

    接口AES密钥获取请参考填入AES密钥

    说明
    • 小程序LOGO图片上传前,需先完成商家券产品绑定,详细内容请参考商家券

    • 商详页店铺名与店铺搜索宣传透出,需使用新商品详情页场景模板。

    • 店铺品牌全称:主要用于商家券详情中展示商家的品牌名、商品详情页中店铺名透出等。

      说明

      品牌全称建议不超过9个汉字。

      image.png

    • 店铺品牌简称:主要用于商品详情页中店铺搜索宣传。image.png

开发设置

登录支付宝开放平台,访问开发>开发设置,并进行如下操作。

接口加签方式(密钥/证书)

详情可参考支付宝开放平台密钥工具,简化步骤如下:

  1. 下载支付宝开放平台开发助手软件,下载地址:

    WINDOWS

    说明

    Windows 版本工具请不要安装在含有空格的目录路径下,否则会导致公私钥乱码的问题。

    MAC_OSX

  2. 生成密钥

    打开安装好的软件,按下图配置,单击生成密钥。其中应用私钥的内容在LinkedMall品牌商城后台中填写(填入密钥),应用公钥在支付宝开放平台中填写(填入公钥)。image.pngimage.png

  3. 支付宝小程序控制台开发>开发设置>开发信息界面,单击接口加签方式(密钥/证书)右侧设置

  4. 阅读注意事项,单击确认,然后按照系统提示流程操作。

  5. 接口加签方式选择密钥(普遍适用),单击下一步,系统会提示下载2.0.0版本的密钥工具,如果已经下载请忽略,单击下一步

  6. 填入公钥

    应用公钥输入框中输入生成密钥中密钥工具生成的应用公钥,单击下一步image.png

  7. 安全验证

    • 如果小程序未绑定手机号,单击立即绑定手机进入绑定手机号界面。

    • 如已绑定则通过绑定手机号获取验证码,单击确认上传。image.png

  8. 获取支付宝公钥

    单击复制按钮,可拿到支付宝公钥信息。image.png

  9. 填入密钥

    在LinkedMall品牌商城运营控制台多端>小程序>支付宝小程序(继续商城小程序基础配置之后的操作内容),填入应用私钥生成密钥),支付宝公钥获取支付宝公钥),填写时请仔细核对。

    image.png

接口内容加密方式

  1. 生成密钥

    1. 支付宝小程序控制台开发 > 开发设置 > 开发信息界面,单击接口内容加密方式右侧设置,在弹出界面单击生成新密钥

    2. 回到开发信息界面,单击接口内容加密方式右侧查看后在跳转界面单击image.png进行复制。

  2. 填入AES密钥

    在LinkedMall品牌商城运营控制台多端>小程序>支付宝小程序界面,在接口AES密钥框中填入AES密钥。image.png

服务器域名白名单

小程序需添加服务器域名白名单,在白名单中的域名的请求才可以正常访问/请求。

说明

如商家搭建过试用版小程序,在切回独立(自有)域名后,需要重新添加小程序服务器域名白名单,并在添加完成后,将搭建试用版小程序时所添加的域名从白名单中删除,详细操作请参考域名切换

  1. 获取需要加白的域名。

    在运营控制台多端>小程序>支付宝小程序界面完成支付宝小程序注册商城小程序基础配置)后,单击下一步,系统将会生成合法域名,单击右侧image.png复制域名。image.png

  2. 添加服务器域名白名单。

    支付宝小程序控制台设置>开发设置界面,单击服务器域名白名单右侧添加按钮,依次添加生成的合法域名image.png

开通客服

支付宝小程序控制台基础设置>小程序信息界面,单击右上角编辑,在线客服选择蚂蚁智能客服 ,单击保存,即开通蚂蚁智能客服。image.png

支付宝服务配置

设置>支付宝服务配置界面,选择专业模式,选择小程序的关联聊天窗,自定义是否开启首页入口,单击生效

说明

首页入口如打开,首页将显示悬浮客服入口,因缓存原因,一般打开后第2天才会生效。

image.png

获取租户ID和聊天窗ID

设置>服务窗配置界面,单击在线聊天窗下方右侧部署,在右侧弹窗中获取租户ID聊天窗ID。image.png

配置客服

进入商城运营控制台店铺>页面管理>系统交易页,选择页面标签为商品详情个人中心的页面,单击右侧编辑,进入页面编辑页的客服链接设置项,选择外部链接>客服,输入租户ID聊天窗ID,单击确认

image.png

商家还可以通过单图浮动工具等基础组件配置外部链接>客服为首页等页面实现智能客服入口,配置方法同上。

说明

如配置聊天窗时已经打开了首页入口展示,建议无需再为首页配置客服入口。

获取蚂蚁智能客服更多支持

蚂蚁智能客服的配置与使用请参考蚂蚁客服官方文档,更多配置指引请参考配置流程

同时,商家可加入蚂蚁智能客服官方服务钉钉群,获得更多人工服务与支持。

image.png

成员管理

  1. 商家如有多成员管理需求,需要将成员(支付宝账号)添加到小程序的成员中。

    支付宝小程序控制台基础设置 > 成员管理界面,单击左上角image.png,在开发成员界面输入支付宝账号后单击查找,查找完成后单击确定

    说明

    单次可搜索并添加最多20个成员。

    image.png

  2. 添加对应成员的支付宝账号后,需该成员打开支付宝APP,进入首页>消息中心(消息盒子)中确认加入。

  3. 该账号的状态显示为已加入表示加入成功。image.png

支付券

商家使用支付券需要满足以下条件:

  • 小程序收款方式需设置为支付宝原生支付。

    说明

    设置方法参考运营控制台篇支付账号收款配置

  • 需要商家联系支付宝收款账号的业务BD,将账号的优惠券退款模式改为含单品的等比例退款,并复制此链接发给支付宝业务BD。

    https://yuque.antfin-inc.com/docs/share/a32ab5d4-400b-493e-a609-670da26714f9

重要
  • 含单品的等比例退款模式请商家务必执行修改操作,否则可能会因消费者的退单而引起资损。

  • 该链接为内部链接,仅支持复制,无法打开。

支付券更多运营内容可咨询LinkedMall品牌商城运营小二。