1. 采用HTTPS协议传输通信数据，防止数据被截获，解密。

2. 采用RSA非对称密钥，明确交互双方的身份，保证交互主体的正确性和唯一性。

3. 支持动态条码，防止冒用会员卡。

4. 手机号等个人信息脱敏显示。

收起

1.会员体系：包括会员权益、积分体系、会员等级等，其中会员权益是不可或缺的，其他项商户按需设计。

2.卡识别方式：分为人工识别和扫码识别。人工识别是由店员人工核实手机号、卡号等作为会员身份标识；扫码识别指借助扫描设备，扫描二维、条码来识别会员身份。商户可根据实际业务场景按需选择。

3.服务入口:商户通过自定义栏位给用户提供服务，譬如：会员信息查询修改、查询附件门店、查询消费记录、积分兑换、优惠券权益查询等服务。

4.消息触达：当会员积分、权益、会员等级等发生变动时，商户可以通过服务窗单发模板消息接口、短信等方式及时通知用户。

收起

1.会员卡栏位数量：自定义栏位按需添加，为了用户体验和功能完整性，建议会员卡栏位数不低于3个。

2.卡面规范：卡面背景图与logo需分别设计，logo不能用透明背景，图片大小符合接口文档要求。

集成注意点：

1.模板创建：商户CRM后台实现卡模板创建功能，商户可在后台管理创建卡模板，具备图片上传、自定义栏位等功能，并记录卡模板id(template_id)。

2.模板修改：商户CRM后台实现卡模板修改功能。

3.领卡渠道来源区分：商户H5领卡链接可配置自定义参数用以识别不同渠道；支付宝端的领卡链接，需按固定格式添加渠道标识参数，具体参考：查看领卡渠道参数

4.用户卡号唯一性：同一用户需要确保其会员卡号唯一。譬如：用户删卡后再开卡。

5.会员卡更新：当会员等级或积分变动时需调用会员卡更新接口更新信息。

收起

接入支付宝会员卡能力，需要在开放平台创建一个应用，通过该应用来调用API。

若还未成为开放平台的入驻服务商或者商户, 请完成入驻指引。

了解应用创建步骤   |  开始创建应用

给应用添加【商户会员卡】和【获取会员信息】功能，这样你的应用就获得了开展会员卡业务必须的接口权限。

了解如何添加功能   |   立即开始添加

签约

会员卡产品和获取默认会员信息无需签约即可使用。

配置密钥

为了保证通信双方的身份和数据安全，需要配置双方密钥。

了解支付宝密钥处理体系   |   生成密钥   |   配置密钥

应用上线

支付宝开放平台的应用上线

了解应用上线

收起

开发语言和SDK

开发者可以使用多种开发方式接入支付宝能力，开放平台提供了支持主流开发语言的SDK接入的方式, 建议开发者采用SDK接入模式，也支持使用自己熟悉的编程语言构造HTTP请求接入支付宝能力。

了解更多SDK接入   |   下载SDK

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", APP_ID, APP_PRIVATE_KEY, "json", CHARSET, ALIPAY_PUBLIC_KEY, "RSA2"); //获得初始化的AlipayClient
//创建API对应的request类
AlipayTradePayRequest request = new AlipayTradePayRequest();
request.setBizContent("{" +
"    \"out_trade_no\":\"20150320010101001\"," +
"    \"scene\":\"bar_code\"," +
"    \"auth_code\":\"28763443825664394\"," +
"    \"subject\":\"Iphone6 16G\"," +
"    \"store_id\":\"NJ_001\"," +
"    \"timeout_express\":\"2m\"," +
"    \"total_amount\":88.88" +
"  }"); //设置业务参数
//通过alipayClient调用API，获得对应的response类
AlipayTradePayResponse response = alipayClient.execute(request);
System.out.print(response.getBody());
//根据response中的结果继续业务逻辑处理

了解更多HTTP方式接入

https://openapi.alipay.com/gateway.do?timestamp=2013-01-01 08:08:08&method=alipay.trade.pay&app_id=2284&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&biz_content=
  {
    "out_trade_no":"20150320010101001",
    "scene":"bar_code,wave_code",
    "auth_code":"28763443825664394",
    "subject":"Iphone6 16G",
    "seller_id":"2088102146225135",
    "total_amount":"88.88",
    "store_id":"NJ_001"
  }

收起

沙箱环境供调试使用

为了方便开放者调试支付宝能力，我们已经准备好沙箱环境，包括沙箱环境账号和沙箱版支付宝钱包，这样就可以在沙箱环境调试了。

了解更多接入沙箱环境   |   开始接入沙箱环境

收起

在线下门店可以铺设物料，用领卡页URL生成二维码实现扫码领卡

由于物料更换不方便、卡模板变更可能性以及扫码识别客户端需求，不建议直接使用开卡组件返回的领卡链接

建议部署商户/ISV自己的领卡链接，一般建议增加门店编号参数，每个门店生成不同的二维码来识别领卡来源。扫码后通过客户端user-agent判断是否是支付宝扫码，如果不是支付宝客户端扫码，引导用户支付宝扫码领会员卡。

体验入口：

收起

通过生活号单发模板消息接口，发送领卡模板消息（COMMON_MSG_TEMPLATE_INTERESTS_CHANG ）实现，对于支付成功页未领卡用户，进行推送，触达用户进行领卡

对于已关注商户生活号的支付宝用户，领卡消息推送到生活号；未关注生活号用户，则推送到钱包消息中心

注意：需要商户控制发送逻辑，用户支付成功一定时间未领卡用户，再推送该消息推荐用户领卡

如图：

收起  |  了解开发对接细节

如图：

收起  |  打开生活号后台

支付成功页推荐领卡为支付宝受限领卡渠道，需向业务经理申请通过才能配置使用

申请需提供Logo（73x73），文案字数（最多两行，每行不超过9个字），支付pid与领卡链接(需提供开卡组件返回的领卡链接)对应关系，实际需要信息请与业务经理确认

若有多个支付pid对应配置同一个领卡链接，需要提供支付pid与会员卡pid对应关系，支付宝端需配置，避免重复推荐领卡

对于支付间连接入商户，需要通过间连受理机构进行分级商户入驻，完成商户入驻后，支付宝会返回唯一标识该商户的编号（sub_merchant_id简称smid）,在支付成功页推荐领卡配置申请时提供smid，用于识别推荐

如图：

收起

收起

会员卡市场为支付宝受限领卡渠道，需向支付宝业务经理申请通过才能配置使用

申请需提供领卡链接(需提供开卡组件返回的领卡链接)，卡市场banner（750x380），卡市场展示卡面（220x140），实际需要信息请与业务经理确认

如图：

收起

为了便于支付宝端对开卡来源进行识别统计区分，需按如下规则设置。

1.接入会员卡开卡组件，提供开卡组件返回的领卡链接，领卡链接前缀必须为 menberprod.alipay.com

2.在领卡链接最后，加上会员来源数据区分字段"&channel=(会员来源字段)"

3.会员来源数据区分字段如下:
  支付成功页：kb_payresult
  卡市场渠道：alipay_cardMarket
  消息中心：Message_center
  生活号渠道:
     a.菜单 lifeapp_menu
     b.关注下发lifeapp_follow
    c.内容(也就是素材)lifeapp_content

4.举例：https://memberprod.alipay.com/account/openform/activecard.htm?app_id=2016071401616416&template_id=20170517000000000240297000300344&__webview_options__=canPullDown%3dNO%26transparentTitle%3dauto&out_string=201928393932&callback=https://wx.erke.com/ali/auth/server.ashx&channel=alipay_cardMarket (确认链接前缀OK，链接最后加上&channel=alipay_cardMarket字段)

收起

注意付钱码存在30s~2分钟的有效期，若需要口头沟通权益使用场景，超时支付失败，请重新扫付款码完成支付

PS:查询握手用户信息接口(动态id查询用户支付宝账户uid)需要向对应BD申请开通

收起  |  

收起

收起

会员卡外部权益领取:卡详情中部banner位具备部署领券活动的能力，需接入卡详情外部权益接口。在会员卡详情中露出商户外部优惠权益，通过点击领取跳转商户H5获取相关优惠权益。此处营销渠道仅个别行业向支付宝业务经理申请通过才能配置使用。

了解具体接入  |  样例

收起

商户自运营，用户领卡送优惠券。

非口碑外部商户发券可以通过alipass产品为用户推送优惠券。了解具体接入

口碑外部商户发券可以通过口碑商家优惠券产品为用户推送优惠券。了解具体接入

收起

1.商户H5页面响应时效。卡详情页点击访问商户H5，响应流畅，为了用户体验要求在3s内响应。

2.商户H5页面响应可用性。卡详情内点击访问商户H5，确保可访问。

收起