引言

本文档阅读对象为商户或ISV的开发和产品人员。该文档不仅描述了会员卡产品的基础集成流程，也讲解了各场景/环节如何使用支付宝的相关能力，便于开发者对会员卡产品整体大图有清晰的了解。同时对于不同行业/卡种，我们也提供了对应的技术方案，请按需参考。

1. 名词解释

• 口碑行业：阿里巴巴集团与蚂蚁金服集团整合双方资源，联手打造的一家互联网本地生活服务平台，覆盖餐饮、超市、便利店、外卖、商圈、机场、美容美发、电影院等八大线下场景。
• 泛行业：口碑一级类目除美食和超市便利店外，均属于口碑泛行业类，类目链接如下：地址
• 开放平台：蚂蚁金服开放平台基于支付宝的海量用户，将强大的支付、营销、数据能力，通过接口等形式开放给第三方合作伙伴，帮助第三方合作伙伴创建更具竞争力的应用。入口
• 卡包（alipass）：支付宝公司推出的一款可以管理电子凭证的产品，该产品聚合来自各类生活服务的票据凭证，包括优惠券、折扣券、代金券、换购券、电影票、演出票、火车票、机票。
• 生活号：支付宝为企业、组织和个人提供的直接触达用户的服务平台，是用户连接世界的交互视窗。入驻的服务提供者可以通过此平台对用户进行信息推送、服务输出、交易场景打通和会员关系管理。
• pid：合作者身份ID（PID）是商户与支付宝签约后商户获得的支付宝商户唯一识别码，2088开头的16位数字。查看PID
• app_id：支付宝分配给开发者的应用ID，即应用身份标示。可登录开放平台，在“开放平台-管理中心”查看。
• uid：user_id的简称，用于表示支付宝用户的唯一标示，以2088开头的16位数字。
• BD：Bussiness Development，支付宝业务经理，针对KA商户提供一对一服务。
• 部分开放：部分业务功能，不会全量开放，有些是行业特定开放，有些是KA商户定向开放，请找贵司对应的业务经理确认。

2. 会员卡基础开发流程概述

会员卡简述：

会员卡产品是商户营销的基础能力，满足商户对于持有会员卡用户的营销需求。
会员卡功能主要围绕会员卡的创建、领取、修改以及同步交易设置了一系列接口，开发者可以根据自己想实现的效果选择合适的接口进行开发，以实现行业各有特色的会员卡应用。

系统架构

负责接入支付宝的会员卡模块一般由企业CRM系统提供，也可以单独建立会员卡系统与企业原有CRM打通。不管哪种方式，都需要与POS做一定程度的打通以实现会员权益的落实和积分累积。

安全设计

为保证信息安全，需要注意安全方面的设计：
支付宝安全机制 | 商户需考虑的安全设计 | 了解更多安全设计指南

1.数据传输过程中建议使用https协议。
2.会员卡中展示的个人信息需要脱敏。 详见脱敏规则

3.手机号、身份证号禁止作为外部会员卡号参数，如果实际场景中采用类似敏感信息作为会员卡号，请先做映射。

收起

开发前准备阶段

进行开发前，需要先在支付宝开放平台创建应用，添加相应功能，配置密钥，才可以在线上调用。我们也提供了sdk和沙箱环境方便开发者调试。
开发应用准备 | 开发工具准备 | 联调环境准备

1.创建应用

接入支付宝会员卡能力，需要在开放平台创建一个应用，通过该应用来调用API。
若还未成为开放平台的入驻服务商或者商户, 请完成 入驻指引。
了解应用创建步骤  |   开始创建应用

2.配置应用

会员卡产品和获取会员信息产品无需签约，给应用添加【商户会员卡】和【获取会员信息】功能，这样你的应用就获得了开展会员卡业务必须的接口权限。
了解如何添加功能  |   立即开始添加

3.配置密钥

为了保证通信双方的身份和数据安全，需要配置双方密钥。
了解支付宝密钥处理体系  |   生成密钥  |   配置密钥

为了确定通信双方(商户和支付宝)的身份和通信数据的安全，需要对通信数据进行双方校验

应用公钥（商户自身的RSA公钥）: 支付宝使用该公钥验证该请求是商户发起。
支付宝公钥（支付宝的RSA公钥）：商户使用该公钥验证该结果是支付宝返回的。
了解更多

收起

4.应用上线

支付宝开放平台的应用上线。上线后才有权限在线上环境调用接口。
了解应用上线

收起

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中的结果继续业务逻辑处理

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"
  }

会员卡基础开发流程

创建会员卡流程

具体接入参考
会员卡标准接入文档 | 集成注意事项

2. 会员注册及发卡环节

商户通常需做个前置H5页面，进行领卡说明和领卡促销活动宣传。在H5页面上配置领卡入口，点击后进入支付宝的开卡页面，商户可以自行配置所需要获得的用户信息，部分信息支付宝默认提供，部分信息需要用户主动输入。

领卡渠道

商户可以提供多种领卡渠道，便于新用户转化成会员或老会员领取会员卡。
领卡渠道分为全开放渠道与部分开放的渠道。部分开放渠道仅针对部分行业/商户/场景开放，详情需联系对应业务经理咨询。
全开放渠道包括：门店扫码领卡 | 消息中心领卡 | 生活号后台发送消息领卡 | 短信或者外部H5广告位领卡
部分开放渠道包括：支付成功页推荐领卡 | 卡包会员卡市场

发卡渠道来源识别[可选]

支付宝需要针对发卡渠道来源做标示，以便后续进行数据统计分析及针对性营销。
对于非支付宝体系内的渠道，商户可以自行做参数标示。
对于支付宝体系内的渠道，商户需要按要求进行传参，以便支付宝筛选统计。具体规则如下：
了解传参规则

发卡促销/开卡送礼[可选]

为了提高会员卡领取率(已有会员更换电子卡)，转化会员率(成为新会员)，商户可以通过发送红包，赠送优惠券等营销活动吸引用户。
详见第5节会员卡做营销活动->营销产品。

3. 会员卡使用环节

领取过会员卡的用户，可在支付时出示电子会员卡，商户收银时扫描卡面上的条码得到卡号进而识别会员，并落实相应权益。

卡码合一

除了在支付前先验证会员卡的方式外，也可使用卡码合一方案。支付时，收银员扫用户付款码，通过动态id查询用户支付宝账户uid，自动识别会员身份，核实用户权益，进行核销，完成卡码合一支付。
了解详细流程

注意付款码存在30秒~2分钟的有效期，若识别用户身份后需要口头沟通权益使用场景，可能导致超时支付失败，需重新扫付款码完成支付。
PS:查询握手用户信息接口(动态id查询用户支付宝账户uid)需要向对应业务经理申请开通。

查询握手用户信息接口

收起

自动积分

对于在支付宝开卡的用户，在不出示会员卡的情况下直接使用支付宝支付，支付成功后商户系统获得用户支付宝uid，应匹配到对应会员身份，自动获得积分等非实时权益。
了解详细流程

核销后通知

详见下节，会员触达

4. 会员触达

当会员积分、权益、等级等发生变动时，商户需要做两件事情：
1.调用会员卡更新接口更新会员权益。
2.对用户进行通知。
在支付宝端内，通过生活号单发模板消息接口通知用户。(需要商户开通生活号，并且激活开发者模式。)对于未关注商户生活号的用户，会推送到支付宝app消息中心；已关注商户生活号的用户，则推送到生活号中。
了解具体接入

5. 会员卡做营销活动

商户可以进行会员营销活动，并通知会员卡。

活动曝光

商户可以通过生活号，自有线上渠道等曝光，也可以在会员卡自定义栏位单独提供活动入口，并结合用户触达方式对用户进行消息推送。
商户既可以在消费前提前提供领券入口。也可以在消费后，由商户系统自行为用户发券，用户在下次消费时进行核销。
另外，在会员卡详情中部的banner位我们也具备部署领券活动的能力，可在此处露出商户外部优惠权益，通过点击领取跳转商户H5获取相关优惠权益。此功能仅部分开放，详情请咨询对应业务经理。了解具体接入
如图：

营销产品

对于通用行业，我们提供了支付宝现金抵价券及无资金商户优惠券两款营销产品。二者区别

除了优惠券以外，商户也可采用发送现金红包的营销活动，直接给用户赠送一笔现金红包。
对于口碑行业，我们提供了口碑商家优惠券产品为用户推送优惠券。
支付宝还提供了卡包产品(Alipass)

发券后如何打开卡券页面：
卡券url scheme

另外，支付宝针对特殊行业/商户/场景提供了相关营销资源协助商户进行营销，如其他商家的优惠券联合营销。详情请联系支付宝业务经理沟通。

6. 服务场景

商户通过自定义栏位，给用户提供会员服务，譬如：会员信息查询修改、权益和等级查询、积分查询和兑换、优惠券权益查询、查询附件门店、查询消费记录等。
服务内容商户按需提供，为了用户体验和功能完整性，建议栏位(服务内容)不低于3个。
同时支付宝客户端允许前端H5页面通过特定的JS方法，直接调用对应的拍照、分享、导航等Native功能，支撑商户业务需求并增强用户体验。
示例：

支付宝提供了JS和JS SDK两种方式以供开发者使用：
jsapi | jssdk
除此之外，支付宝提供了一套对外开放的APP视觉交互规范(蚂蚁金服无线H5样式库AntUI)，旨在帮助用户快速完成H5页面开发，并提供给用户在支付宝APP内一致的体验。
antui

7. 返佣场景[部分开放]

如果贵司签约了会员卡发卡激励活动，需要在接口上做相关设置，以便支付宝识别有效发卡量。
请在alipay.marketing.card.open(会员卡开卡)接口中，按照下图设置对应参数：

open_card_channel 填固定值“commission_partner” , open_card_channel_id填返佣PID。
激励规则：
返佣账单：
返佣申诉：
返佣服务电话：

8. 第三方ISV接入场景[可选]

商户可以把会员卡接口权限授权给ISV，由ISV代商户调用接口开展业务。了解更多

特殊场景

商户的支付系统与会员系统分别由两家ISV提供。会员系统需要获得支付数据以便进行会员积分等业务，通常我们建议支付系统和会员系统打通支付数据，如果无法打通，我们提供了两种备选方案：
PLAN A | PLAN B

9. 卡种专属场景[可选]

针对不同的行业或场景，除了通用集成方案外，可能涉及个性化方案及产品。
1>.网吧

1.网吧行业整体方案
2.涉及功能点：
1>.会员卡用户身份信息输出
因为用户上网必须使用省份证进行联网认证，网吧系统是以身份证作为为用户身份标识的。基于此场景，支付宝特批针对网吧KA商户输出用户身份证信息，在用户开卡环节，免去用户输入身份证的步骤，简化开卡成本。需要BD申请配置。如图：

2>.会员卡充值功能
会员卡给用户提供充值功能，供会员支付网费。可提供一次性充值功能，或者允许用户签约代扣协议，当低于一定额度时，自动从用户账号中扣取费用。
Wap支付产品  |   商户代扣产品
3>.芝麻信用
...

收起

2>.口碑行业：餐饮，快消，泛行业
3>.时段卡：景区
4>.通卡：景区通卡？

10. 会员卡功能保障

商户需要保障会员卡发卡链路和自定义栏位服务的稳定性。

监控服务：

支付宝端支持对会员卡自定义栏位url做可用性检测。暂未做全量配置，如有需要可提供appid给到对应技术支持由支付宝端进行监控。
检测规则：每5分钟扫描一次，扫描时段从早8点到晚上10点，如果十分钟产生2次扫描异常就报警，我们会通知对应商户。

保障入口：

线上环境会员卡产品和接口出现问题时，请先自行排查。
如需支付宝技术协助请反馈支付宝线上保障渠道。

问题：
1.调试环节是否增加关闭安全代理说明？
2.方案是否分为标准全开放版本和vip版本？ vip包含开卡支付宝送礼，返佣等内容
3.该功能无法访问：支付宝与合作ISV协同提供了会员卡管理CRM后台样例以便开发者体验。立即体验
4.是否包含(数据统计与分析场景 章节：大数据？用户画像，精准触达，数据回流等)？

FAQ