品牌零售会员卡集成方案

 

本文将带您在品牌零售行业集成支付宝会员卡。

创建应用  在开放平台创建一个应用

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

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

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

 

配置应用  为创建的应用添加所需功能

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

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

 

签约

会员卡和获取会员信息都是全开放能力,服务商和商户都无需签约即可使用。

 

配置密钥

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

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

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

应用公钥(商户自身的RSA公钥): 支付宝使用该公钥验证该请求是商户发起。

支付宝公钥(支付宝的RSA公钥):商户使用该公钥验证该结果是支付宝返回的。

收起

 

设计  接入设计

常见系统架构

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

 

安全设计

为了保证信息安全,支付宝采用了一系列的安全手段

了解更多安全手段   |   了解更多安全设计指南

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

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

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

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

收起

 

开发  开发应用与支付场景实现

SDK和开发语言

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

了解更多SDK接入   |   下载SDK

以java语言为例,调用会员卡开卡接口alipay.marketing.card.open:

AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do", APP_ID, APP_PRIVATE_KEY, "json", CHARSET, ALIPAY_PUBLIC_KEY, "RSA2"); //获得初始化的AlipayClient
//创建API对应的request类
AlipayMarketingCardOpenRequest request = new AlipayMarketingCardOpenRequest(); 
request.setBizContent("{" +
"    \"out_serial_no\":\"201606270000001\"," +
"    \"card_template_id\":\"201606270000001\"," +
"    \"card_user_info\":{" +
"      \"user_uni_id\":\"2088302463082075\"," +
"      \"user_uni_id_type\":\"UID\"" +
"    }," +
"    \"card_ext_info\":{" +
"      \"biz_card_no\":\"1000001\"," +
"      \"external_card_no\":\"EXT1110000001\"," +
"      \"open_date\":\"2014-02-20 21:20:46\"," +
"      \"valid_date\":\"2020-02-20 21:20:46\"," +
"      \"level\":\"VIP1\"," +
"      \"point\":\"88\"," +
"      \"balance\":\"124.89\"" +
"    }," +
"    \"member_ext_info\":{" +
"      \"name\":\"李洋\"," +
"      \"gende\":\"MALE\"," +
"      \"birth\":\"2016-06-27\"," +
"      \"cell\":\"13000000000\"" +
"    }" +
"  }"); //设置业务参数
//通过alipayClient调用API,获得对应的response类
AlipayMarketingCardOpenResponse response = alipayClient.execute(request); 
System.out.print(response.getBody());
//根据response中的结果继续业务逻辑处理

收起   |   了解更多SDK开发接入细节   |   查看相关的API

了解更多HTTP方式接入

以调用会员卡开卡接口alipay.marketing.card.open为例,构造http请求发起支付:

请注意需要对请求做urlencode处理,以下请求是为了方便查看,而没有做urlencode的原始报文

https://openapi.alipay.com/gateway.do?timestamp=2013-01-01 08:08:08&method=alipay.marketing.card.open&app_id=2284&sign_type=RSA2&sign=ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE&version=1.0&biz_content=
  {
    "out_serial_no":"201606270000001",
    "card_template_id":"201606270000001",
    "card_user_info":{
      "user_uni_id":"2088302463082075",
      "user_uni_id_type":"UID"
    },
    "card_ext_info":{
      "biz_card_no":"1000001",
      "external_card_no":"EXT1110000001",
      "open_date":"2014-02-20 21:20:46",
      "valid_date":"2020-02-20 21:20:46",
      "level":"VIP1",
      "point":"88",
      "balance":"124.89"
    },
    "member_ext_info":{
      "name":"李洋",
      "gende":"MALE",
      "birth":"2016-06-27",
      "cell":"13000000000"
    }
  }

收起  |   查看相关的API

 

制作会员卡

在发放会员卡之前,商户首先需要设计会员卡在支付宝展现的样式和功能区块,并调用接口创建一个支付宝会员卡模板。

了解会员卡模板模型和接口调用说明  |  立即体验

商户业务人员根据支付宝会员卡模板模型设计会员卡卡面样式和栏位,并准备相应的图片素材,然后由商户系统调用支付宝接口创建卡模板。模板中使用的图片素材(如卡背图、LOGO图)需要单独先通过图片上传接口上传至支付宝并获得图片ID。

收起  |   了解会员卡模板模型和接口调用说明

 

会员开卡

创建好会员卡模板后,就可以通过接口开卡。通常商户/ISV需要自行实现一个H5开卡页面,用户在该页面上填写开卡必要的信息(如手机号、性别等,由商户实际业务决定),同时完成用户授权流程后,由商户/ISV调用支付宝接口开卡。
除了新会员开卡,商户也可以通过用户填写的信息匹配原有老会员,并使用CRM中现有的会员信息开卡。

了解详细流程  |   立即体验

如上图所示,商户/ISV需要开发并部署用户开卡页面,并对接支付宝用户信息授权和会员卡开卡相关接口。

收起  |   了解更多开发细节

 

投放领卡渠道

用户领取支付宝会员卡的渠道主要包括门店扫码领取和生活号(服务窗)消息推送。

由于领卡页面由商户/ISV自行开发并部署,只需要用领卡页URL生成二维码即可实现扫码领卡。一般建议增加门店编号参数,每个门店生成不同的二维码来识别领卡来源。

了解生活号消息推送  |   立即体验

对于已关注商户生活号(服务窗)的支付宝用户,可通过以下两类接口发送消息。

异步单发消息(客服接口):用户主动与生活号发生交互(如关注、进入等动作)时,可向用户发送一条图文消息,引导用户领取会员卡。

模板消息:按照指定的模板,在指定的时机向指定用户发送消息,商户/ISV可自动以模板中的变量内容。例如用户在门店使用支付宝支付后,向会员发送会员招募信息。

收起  |  了解异步单发消息开发  |  了解模板消息开发细节

 

使用会员卡

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

对于在支付宝开卡的用户,在不出示会员卡的情况下直接使用支付宝支付,可自动获得积分等非实时权益。

了解详细流程   |   立即体验

收起  |  

 

调试应用  沙箱环境供调试使用

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

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

 

上线应用  上线应用所需步骤

上线

商户本身应用上线时候,也要把支付宝开放平台的应用上线。

了解更多上线动作

 

第三方授权

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

了解更多第三方授权

 

onlineServer