升级至 3.0 版本 -凯发app官方网站

产品地图

支付产品

私域产品

公域产品

营销产品

支付券

商家券 2.0

商家会员卡

产品介绍

接入准备

接入指南

api 列表

相关资料

升级指南

历史文档

营销活动送红包

红包

棋盘密云

芝麻实力标

资金产品

会员产品

信用产品

安全产品

广告产品

其他通用产品

更新时间：2024-11-12 17:53:20

文档更新记录 >

订阅更新

我的文档

设置

1 简介

本文档适用于已接入

商家会员卡

功能，并想要与支付宝进行合作的商家（如：入会与会员积分兑换打通、开卡送券等活动）阅读，商家可根据本文指引进行功能升级。

说明：

●

同支付宝账号下任意应用创建的会员卡模板可通用，且历史创建会员卡模板也可继续使用，还可根据

基础功能

创建会员卡模板指引创建新模板并设置开卡表单。

●

小程序应用升级方案参见

小程序会员卡升级方案

。

2 升级流程说明

已接入商家会员卡的

网页&移动应用

、

生活号

商家可通过

重新生成领卡链接

进行升级，流程如下。

2.1 第一步：前置判断

商家可根据本步骤指引，测试老

callback

地址是否支持最新开卡方案需求，若支持则无需升级。

在老开卡链接后，拼接

&channel=member_benefit

，示例如下：

https://memberprod.alipay.com/account/openform/activecard.htm?app_id=2019111569179437&template_id=20210429000000002712446000300297&__webview_options__=canpulldown=no&transparenttitle=auto&out_string=2021&callback=https://test.callback.com

&channel=member_benefit

生成二维码，使用支付宝扫码开卡。

○

若开卡成功，则

无需升级

。

○

若开卡失败，则根据下文完成升级。

2.2 第二步：获取新领卡链接

商家通过

网页&移动应用

、

生活号

应用 appid 调用

alipay.marketing.card.activateurl.apply（获取会员卡领卡投放链接接口）

并传入新

callback

（回调地址），获取新的

apply_card_url

（领卡链接）。

注意：

授权回调的

callback

地址需改用

一个纯的服务端 http 接口，不推荐用页面来中转

。如：直接使用一个 controller，负责接受支付宝的回调、查询支付宝授权信息及给用户发卡。

2.2.1 请求示例

重要入参说明：

●

template_id：必填，会员卡模板id，创建会员卡模板将会返回该 id，可使用相同支付宝主账号下任意应用创建的模板id（包括历史模板）。

●

callback：必填，会员卡领卡表单页面成功回调地址。

●

该地址需为单纯的服务端接收回调。

●

用户同意领卡时，支付宝将通过 get 方式会回调本地址，并且回传

auth_code

、

requestid

参数用于后续开卡。

●

out_string：由商户自定义设置，确认领卡成功后将通过 callback 原样带回。

文档。

2.3 第三步：参数拼接

商家需替换老开卡链接中的 callback 参数值为新 callback 地址，验证可以正常发卡。

商家需根据上文

第一步：前置判断

指引，在新的开卡地址后面拼接

&channel=member_benefit

，验证可以正常发卡。

3 小程序会员卡升级方案

适用于已 2021-06-11 前使用

my.addcardauth

接口接入

小程序商家会员卡

功能，并想要与支付宝进行合作的商家（如：入会与会员积分兑换打通、开卡送券等活动）阅读。商家可根据本文指引进行功能升级，升级后还将支持用户通过支付宝扫码开卡。

说明：

同一支付宝账号下任意应用创建的会员卡模板可通用，且历史创建会员卡模板也可继续使用。

3.1 升级流程说明

已接入商家会员卡的小程序商家可通过

重新生成领卡链接

进行升级。流程如下：

通过

小程序应用

的 appid 调用

alipay.marketing.card.activateurl.apply（获取会员卡领卡投放链接接口）

并传入callback（回调地址）获取新的领卡链接。

投放新领卡链接：

○

投放至小程序并通过

支付宝卡包插件

打开领卡页。

○

将新链接转换为二维码，用户使用支付宝扫码领卡。

用户点击

同意并领取到卡包

提交领卡申请时，支付宝将通过 get 方式向 callback 地址发送 auth_code（用户授权码）、request_id（申请 id）；

通过

小程序应用

的 appid 调用接口换取授权令牌并为用户开卡，可查看下文

小程序开卡

。callback 为回调地址，用户提交开卡申请时，支付宝将向该地址发送 auth_code（用户授权码）、request_id（申请 id）。

4 会员卡模板

同一支付宝主账号下任意应用创建的会员卡模板可通用，且历史创建的会员卡模板可继续使用，还可根据

基础功能

创建会员卡模板指引创建新模板并设置开卡表单。

5 获取新领卡链接

商家通过小程序应用 appid 调用

alipay.marketing.card.activateurl.apply（获取会员卡领卡投放链接接口）

并传入 callback（回调地址），获取新的 apply_card_url （领卡链接）。

5.1 请求示例

重要入参说明

●

template_id：必填，会员卡模板id，创建会员卡模板将会返回该 id，可使用相同支付宝主账号下任意应用创建的模板id（包括历史模板）。

●

callback：必填，会员卡领卡表单页面成功回调地址。

○

该地址需为单纯的服务端接收回调。

○

用户同意领卡时，支付宝将通过 get 方式会回调本地址，并且回传

auth_code

、

requestid

参数用于后续开卡。

●

out_string：由商家自定义设置，确认领卡成功后将通过 callback 原样带回。

6 开取会员卡

用户通过新领卡链接提交开卡申请后，商家需根据用户提交申请途径为用户开取会员卡。

6.1 小程序开卡

开发者需根据

基础功能

小程序内唤起会员开卡授权页面指引，订购

支付宝卡包插件

并通过插件唤起领卡页。

用户提交开卡申请后，支付宝将向领卡链接中的 callback 地址发送 auth_code（用户授权码）及 request_id（申请 id）。

后续使用

小程序应用

的 appid 调用接口获取用户填写的表单信息并为用户开卡即可。

6.2 扫码开卡

用户使用支付宝扫描新领卡链接二维码，提交领卡申请。支付宝将向 callback 地址发送 auth_code（用户授权码）及 request_id 值。商家接收到信息后，使用生成该领卡链接的应用 appid 调用接口

获取用户填写的表单信息

并

为用户开卡

即可。

7 方案验收

商家可根据本步骤指引，测试方案是否升级成功。

在老开卡链接后，拼接

&force_card_order=true

，示例如下：

&force_card_order=true

生成二维码，使用支付宝扫码开卡。

○

若开卡成功，则

升级成功

。

○

若开卡失败，则

升级失败

，建议根据文本指引重新进行升级。

相关问题