简介

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

说明：

同支付宝账号下任意应用创建的会员卡模板可通用，且历史创建会员卡模板也可继续使用，还可根据创建会员卡模板指引创建新模板并设置开卡表单。

小程序应用升级方案参见小程序会员卡升级方案。

升级流程说明

已接入商家会员卡的 网页&移动应用、生活号 商家可通过 重新生成领卡链接 进行升级，流程如下。

第一步：前置判断

商家可根据本步骤指引，测试老 callback 地址是否支持最新开卡方案需求，若支持则无需升级。

在老开卡链接后，拼接 &channel=MEMBER_BENEFIT，示例如下：

https://memberprod.alipay.com/account/openform/activecard.htm?app_id=2019111569179437&template_id=20210429000000002712446000300297&__webview_options__=canPullDown%3dNO%26transparentTitle%3dauto&out_string=2021&callback=https://test.callback.com**&channel=MEMBER_BENEFIT**

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

若开卡成功，则 无需升级。

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

第二步：获取新领卡链接

商家通过 网页&移动应用、生活号 应用 APPID 调用 alipay.marketing.card.activateurl.apply（获取会员卡领卡投放链接）并传入新 callback（回调地址），获取新的 apply_card_url （领卡链接）。

**注意：**授权回调的 callback 地址需改用 一个纯的服务端 http 接口，不推荐用页面来中转。如：直接使用一个 controller，负责接受支付宝的回调、查询支付宝授权信息及给用户发卡。

请求示例

package com.java.sdk.demo;

import com.alipay.v3.ApiException;
import com.alipay.v3.ApiClient;
import com.alipay.v3.util.model.AlipayConfig;
import com.alipay.v3.Configuration;
import com.alipay.v3.api.AlipayMarketingCardActivateurlApi;
import com.alipay.v3.model.*;
import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class AlipayMarketingCardActivateurlApiApply {

    public static void main(String[] args) throws ApiException {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        // 初始化alipay参数（全局设置一次）
        AlipayConfig alipayConfig = new AlipayConfig();
        alipayConfig.setServerUrl("https://openapi.alipay.com");
        alipayConfig.setAppId("<-- 请填写您的AppId，例如：2019091767145019 -->");
        alipayConfig.setPrivateKey("<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->");
        alipayConfig.setAlipayPublicKey("<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->");
        defaultClient.setAlipayConfig(alipayConfig);
        AlipayMarketingCardActivateurlApi api = new AlipayMarketingCardActivateurlApi();
        AlipayMarketingCardActivateurlApplyModel data = new AlipayMarketingCardActivateurlApplyModel();
        data.setFollowAppId("20150000000000000");
        data.setCallback("https://alipay.com/card/demo.htm");
        data.setOutString("201928393932");
        data.setTemplateId("20170228000000000210102000300974");
        try {
            AlipayMarketingCardActivateurlApplyResponseModel response = api.apply(data);
        } catch (ApiException e) {
            AlipayMarketingCardActivateurlApplyDefaultResponse errorObject = (AlipayMarketingCardActivateurlApplyDefaultResponse) e.getErrorObject();
            System.out.println("调用失败:" + errorObject);
        }
    }
}

重要入参说明：

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

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

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

用户同意领卡时，支付宝将通过 GET 方式会回调本地址，并且回传 auth_code、requestId 参数用于后续开卡。

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

更多参数详情参见 alipay.marketing.card.activateurl.apply（获取会员卡领卡投放链接）文档。

第三步：参数拼接

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

商家需根据上文第一步：前置判断指引，在新的开卡地址后面拼接 &channel=MEMBER_BENEFIT，验证可以正常发卡。

小程序会员卡升级方案

适用于已 2021-06-11 前使用 my.addCardAuth 接口接入 小程序商家会员卡 功能，并想要与支付宝进行合作的商家（如：入会与会员积分兑换打通、开卡送券等活动）阅读。商家可根据本文指引进行功能升级，升级后还将支持用户通过支付宝扫码开卡。

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

升级流程说明

已接入商家会员卡的小程序商家可通过 重新生成领卡链接 进行升级。流程如下：

通过 小程序应用 的 APPID 调用 alipay.marketing.card.activateurl.apply（获取会员卡领卡投放链接）并传入callback（回调地址）获取新的领卡链接。

投放新领卡链接：

投放至小程序并通过 支付宝卡包插件 打开领卡页。

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

用户点击 同意并领取到卡包 提交领卡申请时，支付宝将通过 GET 方式向 callback 地址发送 auth_code（用户授权码）、request_id（申请 ID）；

通过 小程序应用 的 APPID 调用接口换取授权令牌并为用户开卡，可查看下文 小程序开卡。callback 为回调地址，用户提交开卡申请时，支付宝将向该地址发送 auth_code（用户授权码）、request_id（申请 ID）。

会员卡模板

同一支付宝主账号下任意应用创建的会员卡模板可通用，且历史创建的会员卡模板可继续使用，还可根据创建会员卡模板指引创建新模板并设置开卡表单。

获取新领卡链接

商家通过小程序应用 APPID 调用 alipay.marketing.card.activateurl.apply（获取会员卡领卡投放链接）并传入 callback（回调地址），获取新的 apply_card_url （领卡链接）。

请求示例

package com.java.sdk.demo;

import com.alipay.v3.ApiException;
import com.alipay.v3.ApiClient;
import com.alipay.v3.util.model.AlipayConfig;
import com.alipay.v3.Configuration;
import com.alipay.v3.api.AlipayMarketingCardActivateurlApi;
import com.alipay.v3.model.*;
import java.io.File;
import java.util.ArrayList;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class AlipayMarketingCardActivateurlApiApply {

    public static void main(String[] args) throws ApiException {
        ApiClient defaultClient = Configuration.getDefaultApiClient();
        // 初始化alipay参数（全局设置一次）
        AlipayConfig alipayConfig = new AlipayConfig();
        alipayConfig.setServerUrl("https://openapi.alipay.com");
        alipayConfig.setAppId("<-- 请填写您的AppId，例如：2019091767145019 -->");
        alipayConfig.setPrivateKey("<-- 请填写您的应用私钥，例如：MIIEvQIBADANB ... ... -->");
        alipayConfig.setAlipayPublicKey("<-- 请填写您的支付宝公钥，例如：MIIBIjANBg... -->");
        defaultClient.setAlipayConfig(alipayConfig);
        AlipayMarketingCardActivateurlApi api = new AlipayMarketingCardActivateurlApi();
        AlipayMarketingCardActivateurlApplyModel data = new AlipayMarketingCardActivateurlApplyModel();
        data.setFollowAppId("20150000000000000");
        data.setCallback("https://alipay.com/card/demo.htm");
        data.setOutString("201928393932");
        data.setTemplateId("20170228000000000210102000300974");
        try {
            AlipayMarketingCardActivateurlApplyResponseModel response = api.apply(data);
        } catch (ApiException e) {
            AlipayMarketingCardActivateurlApplyDefaultResponse errorObject = (AlipayMarketingCardActivateurlApplyDefaultResponse) e.getErrorObject();
            System.out.println("调用失败:" + errorObject);
        }
    }
}

重要入参说明

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

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

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

用户同意领卡时，支付宝将通过 GET 方式会回调本地址，并且回传 auth_code、requestId 参数用于后续开卡。

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

开取会员卡

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

小程序开卡

开发者需根据小程序内唤起会员开卡授权页面指引，订购 支付宝卡包插件 并通过插件唤起领卡页。

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

后续使用 小程序应用 的 APPID 调用接口获取用户填写的表单信息并为用户开卡即可。

扫码开卡

用户使用支付宝扫描新领卡链接二维码，提交领卡申请。支付宝将向 callback 地址发送 auth_code（用户授权码）及 request_id 值。商家接收到信息后，使用生成该领卡链接的应用 APPID 调用接口获取用户填写的表单信息并为用户开卡即可。

方案验收

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

在老开卡链接后，拼接 &force_card_order=true，示例如下：

https://memberprod.alipay.com/account/openform/activecard.htm?app_id=2019111569179437&template_id=20210429000000002712446000300297&__webview_options__=canPullDown%3dNO%26transparentTitle%3dauto&out_string=2021&callback=https://test.callback.com

&force_card_order=true

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

若开卡成功，则 升级成功。

若开卡失败，则 升级失败，建议根据文本指引重新进行升级。

升级至 3.0 版本

简介#

升级流程说明#

第一步：前置判断#

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

请求示例#

重要入参说明：#

第三步：参数拼接#

小程序会员卡升级方案#

升级流程说明#

会员卡模板#

获取新领卡链接#

请求示例#

重要入参说明#

开取会员卡#

小程序开卡#

扫码开卡#

方案验收#

简介

升级流程说明

第一步：前置判断

第二步：获取新领卡链接

请求示例

重要入参说明：

第三步：参数拼接

小程序会员卡升级方案

升级流程说明

会员卡模板

获取新领卡链接

请求示例

重要入参说明

开取会员卡

小程序开卡

扫码开卡

方案验收