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

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

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

收起

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

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

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

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

收起

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

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

集成注意点：

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

2.创建卡模板时，一定不要填shop_ids+open_card_conf.open_card_url+pub_channel.SHOP_DETAIL

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

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

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

6.联盟卡接入：商圈一个pid只允许开一个店d

7.isv代商圈接入会员卡：商圈通过第三方应用授权isv，isv要保存app_auth_token（商圈授权token）和auth_app_id(商圈appid)。调用会员卡业务接口时，要传入app_auth_token。

8.发卡流程测试全部通过后,在聚合页露出开卡入口，则只调用模板修改接口更改该模板open_card_url即可

收起

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

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

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

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

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

签约

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

配置密钥

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

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

应用上线

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

了解应用上线

收起

商圈签约并圈店

1.商圈需要准备一个新的没有签约过当面付的支付宝账号。联系城市BD或者口碑小二为商圈创建综合体，创建之后商户需要登录e.alipay.com确认综合体上线，此时支付宝-口碑不展示综合体，需圈店之后才会展示。

2.商圈圈店。由城市BD/口碑小二/服务商协助商圈圈店；商户自己操作权限需登录口碑商家中心（e.alipay.com）后台，将附近店铺圈起来，完成圈店。完成圈店后商圈聚合页可看到所圈的店铺。

商圈签约并圈店流程图

收起

开发语言和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"
  }

收起

商圈会员卡联调涉及环境

1.商圈入驻并圈店。由城市BD和服务商只能在生产环境操作。

2.会员卡产品对接。支付宝提供了沙箱环境，商户可以根据实际情况选择会员卡联调环境。

3.会员卡自动积分。使用的交易信息订阅产品需在生产环境联调。

综上，建议商圈接入会员卡在生产上联调。

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

收起

第三方授权

服务商希望把应用能力拓展给商圈，那么使用第三方授权就可以获取商圈的授权，代商圈调用接口开展业务。

1.isv拼接第三方应用授权链接，商圈点击进行授权，过程中需使用支付宝企业账号登录，授权完成后，isv保存app_auth_token和auth_app_id(商圈appid)

2.商圈向isv授权完成后，在调用会员卡接口的时候，都需要传入用户的授权app_auth_token。

3.isv调用会员卡产品，接口调用逻辑与标准接入一样。

了解更多第三方授权

收起

接口开发中人工配置

1.商圈支持配置一个模板映射多个mall,也支持一个mall映射多个卡模板。一个mall多个卡模板情况下最后设置开卡链接时，多个卡模板配置的open_card_url要为同一个。

2.邮件申请时写明是mall与模板的关系。邮件发给支付宝业务经理，可同时抄给技术支持。最后由行业pd配置。

3.当多商圈配置同一个卡模板时，用户在其中一个商圈领了卡，在剩下的商圈聚合页也可以看到是该商圈的会员。

4.两个商圈共用卡模板，一套积分体系。如图：

收起

•商圈统一收银:商圈统一开店，以商圈为发卡主体，使用同一套收银系统，商圈账户收款，通过收单接口获取交易记录、会员卡与商圈的CRM系统实现系统打通，会员积分自动累加。

收起

•商圈非统一收银:商圈内商户各自开店，各自收款，没有使用统一的收银系统，以同名多商圈为发卡主体。商圈只有在用户同意支付宝通过交易订阅产品将商户交易信息同步到商圈，才能作为会员卡权益累加的凭证，商圈会员系统实现积分累加。

收起

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

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

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

体验入口：

收起

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

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

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

如图：

收起  |  了解开发对接细节

如图：

收起  |  打开生活号后台

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

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

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

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

如图：

收起

收起

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

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

如图：

收起

口碑商圈聚合页banner可以配置领卡入口。需向支付宝业务经理申请通过才能配置使用。

1.跳转商家聚合页面的schema：alipays://platformapi/startapp?appId=20000238⌖=merchant&shopId=2015060400077000000000161366(其中shopid=mallid:)。

2.门店详情页的开卡入口（open_card_url）自动添加回传mallId。示例如下：https://openauth.alipay.com/oauth2/publicAppAuthorize.htm？app_id=20170224058XXXX≻ope=auth_user,auth_ecard&redirect_uri=XXXXX&mallId=111111111111。

如图：

收起

收起

• 调试接口前需要做两个申请一个注意：

申请1.必须完成邮件申请配置APPID+需要映射的mallid列表+卡模板id关联关系的动作。否则会报商圈未开通会员卡。

申请2.必须向技术支持申请挂商圈综合体接口包。

注意1.如果是isv角色的账号做开发，需要商圈向isv做授权后，isv账号+令牌才可以调用。

• 三个接口联调步骤：

第一步：

koubei.marketing.mall.trade.subscribe(商圈交易信息订阅)

入参：mall_id 和card_template_id（不做强校验）

注意：该接口严格校验开发者appid，商圈，mall_id的映射关系，所以如果是一个开发账号（这个账号可能是isv,可能是mall的签约账号）处理多mall的情况下，需要mall分别向开发账号做授权，带token调用

第二步：

koubei.shop.mall.audit.query(商圈工单审核状态查询)

目前的逻辑是只要第一步完成后，会立刻过渡到审核通过状态。但是以后计划会增加审核。故该接口需要对接，在工单审核状态为success时，才能收到第三步的通知

第三步：

工单状态审核成功后，有用户在mall的门店消费后，且在钱包内同意自动积分功能时，开发者会收到消费信息通知。接收到通知后，返回结果必须是json格式，需要返回{“success”:true}

注意：在mallA开通自动积分后，进入mallB还是需要开通自动积分，目前不能做到一次自动积分操作两家全部开通

post通知内容：https://www.merchant.com/receive_notify.htm?notify_type=koubei_mall_trade_notify¬ify_id=91722adff935e8cfa58b3aabf4dead6ibe¬ify_time=2017-02-16 21:46:15&sign_type=RSA2&sign=Wc+t3D8Kg71dTlKwN7r9PzUOXeaBJwp8/FOuSxcuSkXsoVYxBpsAidprySCjHCjmaglNcjoKJQLJ28/Asl93joTW39FX6i07lXhnbPknezAlwmvPdnQuI01HZsZF9V1i6ggZjBiAd5lG8bZtTxZOJ87ub2i9GuJ3Nr/NUc9VeY=&buyer_user_id=2088102121935776&mall_id=2017011800077010000003496995&shop_id=2017011800077010000003494595&shop_name=测试店铺&category_id=2015112000115301&category_name=美食 &card_template_id=3242340295045&card_no=1332454555345&external_card_no=123145366™_no=144534352534536&total_amount=25.00&buyer_pay_amount=16.50&gmt_payment=2017-05-05 14:24:12

注意：其中的shop_id和shop_name默认情况下不返回，如需要，则发邮件给业务BD，由业务BD向PD申请评估后走配置流程。

收起

收起

商圈聚合页的banner位上的支付宝消费记录按钮链接：https://render.alipay.com/p/h5/code-strategy-mall/www/consumer-recording.html?mallId=201702230007701000002XXXXXXX

开发者可以设计在会员卡卡面，菜单等其他页面展示。

如图：

收起

商圈门店摘要信息批量查询接口-alipay.offline.market.shop.summary.batchquery

注意：

1.查询商圈mallid时，入参只需传query_type=MALL_SELF，op_role=ISV。

2.查询商圈下的门店，如XXX奶茶，XXX女装店时，入参query_type=MALL_RELATION，op_role=ISV，shop_id=真实的mallid，若只查其中某个品牌的店，需再配合related_partner_id。

mall模式的参数

收起

收起

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

了解具体接入  |  样例

收起

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

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

收起

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

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

收起