文档中心 > 技术支持产品对接方案

小程序电子会员卡接入指南

更新时间:2019/04/23 访问次数:441

产品介绍

电子会员卡产品是商户营销的基础能力,实现支付宝账户与商户会员系统互通,并且可将会员卡的积分变化和交易变化等同步到支付宝卡券包。

城服,公服行业通过会员卡,实现用户信息电子化,如电子社保卡,形成与支付宝数据共享

快消,餐饮,零售,综合体等行业,可以通过支付宝会员,实现会员积分,余额管理,对会员精准分层营销

校园行业,实现校园卡电子化,通过一卡实现校园门店购物,水控,餐饮等能力

 

流程简述


image.png

接入前准备

1.文档&工具&SDK

会员卡文档 地址

小程序会员卡 地址

小程序卡包 地址

 

SDK下载 地址

小程序开发工具下载 地址

 

2.小程序开发者入驻 地址

 

3.开发者中心配置(功能包添加)

开发者中心 -> 开发管理 -> 添加功能,添加红框中的功能


image.png

 

4.秘钥配置

开发者中心 -> 设置 -> 开发设置

配置密钥教程image.png

 

技术接入

1.模板接入

1.1上传会员卡的图片

备注:背景图片(1020*643px)&logo图片(500*500px),其他图片可以根据会员卡模板创建接口文档中字段描述自行添加

1.接口地址:https://docs.open.alipay.com/api_3/alipay.offline.material.image.upload

2.代码示例:

 /**
   * 图片上传接口
   */
  private void upload() {
    try {
      // 重新构建alipayClient,养成好的习惯,做到一劳永逸
      AlipayClient alipayClient = AlipayConfig.alipayClient();

      AlipayOfflineMaterialImageUploadRequest request = new AlipayOfflineMaterialImageUploadRequest();
      request.setImageType("jpg");
      request.setImageName("五方会员卡背景图片");
      FileItem ImageContent = new FileItem("D:\\bg.jpg");
      request.setImageContent(ImageContent);
      AlipayOfflineMaterialImageUploadResponse response = alipayClient.execute(request);
      if (response.isSuccess()) {
        System.out.println(response.getBody());
      } else {
        System.err.println("调用失败");
      }

      // 背景bg返回结果,我们提取image_id,留着开卡字段background_id使用
      // {"alipay_offline_material_image_upload_response":{"code":"10000","msg":"Success","image_id":"pU36sTedQlqdoq6wJiZUWAAAACMAAQED","image_url":"https:\/\/oalipay-dl-django.alicdn.com\/rest\/1.0\/image?fileIds=pU36sTedQlqdoq6wJiZUWAAAACMAAQED&zoom=original"},"sign":"VE5jsJ+/zhz1R5Lzgw1D5bc0X36ltHEIW//j0LDp1cMUyfDqG2uT4yVIuqrX3Rk9TYb82igf2Wv9JHUisLlme63n6Ca376veJa5qB1ZglgCDiM9osTeUJALtkvCCe5La8eVp7r2mXC5111gv60I/BzTXWnR4kCkL7g6nJhh/QlfPZ083L22tf3Xnn91JZ+qIPUqFyEHBWD472Xox/OkEMI/IT9cG0K9MNPrS0Ky1ewJq9OnFV07tBJdup7sY4dD4uS/ifwjeLew5qbQ7/If+p7VkElv9/SFvRIYsf6M+Ra/uyIVTo+GacnEZeTr7HlNjuB4XT3qApHy/MtNYy+Uz5A=="}
      // 背景logoid返回结果,我们提取image_id,留着开卡字段logo_id使用
      // {"alipay_offline_material_image_upload_response":{"code":"10000","msg":"Success","image_id":"4_8uBhzITT-H5fhf5UErZQAAACMAAQED","image_url":"https:\/\/oalipay-dl-django.alicdn.com\/rest\/1.0\/image?fileIds=4_8uBhzITT-H5fhf5UErZQAAACMAAQED&zoom=original"},"sign":"UdZ2QlLRXIJ9ISo75k69aqAQ2ejNbAdSMhQ+pNLzkCPebRb/8/A4H81qMn7bEeDSu81xCvgtmCmFrdi2hii1BOzcZQl3g7xP/LLrE0JiQeXAWNPLjAqAa/mwhWJKuTVPviqVeFk/m1llnH6a6N3alPpzCWq8fddBWPVo3vlJE5FceyZ1CSK2tkX7I5IbduHxfbEFjCikIhohofiQzdsQXA6jV7poUrRHLrmgMXXRvvOdLloIGw+cE1RnqhUhDBDaSD7EF2auPlW50+2BgMI08Wfwp8bfJMC+F0nabphN164PH3BKkOAsD2L+xA7frV990wfPk6acccrHKICaZZSJZg=="}

    } catch (Exception e) {
      e.printStackTrace();
    }
  }

1.2会员卡模板创建

1.接口地址:https://docs.open.alipay.com/api_5/alipay.marketing.card.template.create

 

2.会员模板结构

 

3.代码示例:

private void tempCreate() {
    try {
      // 重新构建alipayClient,养成好的习惯,做到一劳永逸
      AlipayClient alipayClient = AlipayConfig.alipayClient();
      
      AlipayMarketingCardTemplateCreateRequest request = new AlipayMarketingCardTemplateCreateRequest();
      //作为开发,这个bizContent一定要保存好!!!
      request.setBizContent(
          "{\"request_id\":\"2019032414000324\",\"write_off_type\":\"none\",\"template_style_info\":{\"card_show_name\":\"五方会员卡\",\"logo_id\":\"4_8uBhzITT-H5fhf5UErZQAAACMAAQED\",\"background_id\":\"pU36sTedQlqdoq6wJiZUWAAAACMAAQED\",\"color\":\"rgb(0,0,0)\",\"bg_color\":\"rgb(0,0,0)\"},\"column_info_list\":[{\"code\":\"DISCOUNT_INFO\",\"more_info\":{\"title\":\"天天领红包\",\"url\":\"https://render.alipay.com/p/f/fd-j779tgl9/index.html?from=ol_studentscard\",\"params\":\"{}\"},\"title\":\"专属优惠\",\"operate_type\":\"openWeb\",\"value\":\" \"},{\"code\":\"BENEFIT_INFO\",\"more_info\":{\"title\":\"支付方式设置\",\"url\":\"vcard.zcmu.edu.cn/paytype\",\"params\":\"{}\"},\"title\":\"支付方式设置\",\"operate_type\":\"openWeb\",\"value\":\" \"},{\"code\":\"SHCOOL_INFO\",\"more_info\":{\"title\":\"关于虚拟卡\",\"url\":\"http://www.baidu.com\"},\"title\":\"关于虚拟卡\",\"operate_type\":\"openWeb\",\"value\":\"\"}],\"field_rule_list\":[{\"field_name\":\"Balance\",\"rule_name\":\"ASSIGN_FROM_REQUEST\",\"rule_value\":\"Balance\"}],\"card_action_list\":[{\"code\":\"PAY_INFO\",\"text\":\"去付款\",\"url\":\"alipays://platformapi/startapp?appId=20000056&source=2018082761125668\"},{\"code\":\"DOOR_INFO\",\"text\":\"刷门禁\",\"url\":\"vcard.zcmu.edu.cn/qrcode\"}],\"card_type\":\"OUT_MEMBER_CARD\",\"biz_no_prefix\":\"pre\",\"biz_no_suffix_len\":\"10\"}");
      AlipayMarketingCardTemplateCreateResponse response = alipayClient.execute(request);
      if (response.isSuccess()) {
        System.out.println(response.getTemplateId());
        // 开卡模板id,核心东西且切记存好
        // 20190322000000001477341000300801
      } else {
        System.err.println("调用失败");
      }
    } catch (Exception e) {
      e.printStackTrace();
    }
  }

1.3会员卡模板修改

备注:修改模板接口和创建接口大同小异,此处不做示例

 

1.文档地址:https://docs.open.alipay.com/api_5/alipay.marketing.card.template.modify

 

1.4会员卡模板查询接口

备注:通过template_id查询会员卡模板结构接口

 

1.文档地址:https://docs.open.alipay.com/api_5/alipay.marketing.card.template.query

 

2.代码示例:

private void tempQuery() {
    try {
      // 重新构建alipayClient,养成好的习惯,做到一劳永逸
      AlipayClient alipayClient = AlipayConfig.alipayClient();
      AlipayMarketingCardTemplateQueryRequest request = new AlipayMarketingCardTemplateQueryRequest();
      request.setBizContent("{\"template_id\":\"20190322000000001477341000300801\"}");
      AlipayMarketingCardTemplateQueryResponse response = alipayClient.execute(request);
      if (response.isSuccess()) {
        System.out.println(response.getBody());
        // 查询结果
        // {"alipay_marketing_card_template_query_response":{"code":"10000","msg":"Success","biz_no_prefix":"pre","biz_no_suffix_len":"10","card_action_list":[{"code":"PAY_INFO","text":"去付款","url":"alipays:\/\/platformapi\/startapp?appId=20000056&source=2018082761125668","url_type":"url"},{"code":"DOOR_INFO","text":"刷门禁","url":"vcard.zcmu.edu.cn\/qrcode","url_type":"url"}],"card_type":"OUT_MEMBER_CARD","column_info_list":[{"code":"DISCOUNT_INFO","more_info":{"params":"{}","title":"天天领红包","url":"https:\/\/render.alipay.com\/p\/f\/fd-j779tgl9\/index.html?from=ol_studentscard"},"operate_type":"openWeb","title":"专属优惠"},{"code":"BENEFIT_INFO","more_info":{"params":"{}","title":"支付方式设置","url":"vcard.zcmu.edu.cn\/paytype"},"operate_type":"openWeb","title":"支付方式设置"},{"code":"SHCOOL_INFO","more_info":{"title":"关于虚拟卡","url":"http:\/\/www.baidu.com"},"operate_type":"openWeb","title":"关于虚拟卡"}],"field_rule_list":[{"field_name":"Balance","rule_name":"ASSIGN_FROM_REQUEST","rule_value":"Balance"}],"template_style_info":{"background_id":"pU36sTedQlqdoq6wJiZUWAAAACMAAQED","bg_color":"rgb(0,0,0)","card_show_name":"五方会员卡","color":"rgb(0,0,0)","logo_id":"4_8uBhzITT-H5fhf5UErZQAAACMAAQED"}},"sign":"Wvg/gyU4is3x0VDG/lL/Ttih0pLXLE3f34OX17U9pOpPrl00EqVoFAHDy2jw+daCLgcZbG7iKQy2wsWy29v1Woaj33IYSfIx55fs3e+mvkDOTrmHOYqww2E5sJ+L4CkdT2BMjC5kaGtZ39IEup9N8Om49a6SR3ylHFGNwfSvBawPqDGkcWoPiBFf9tfbkT+HwS6CvcY1WAo+hfDpzmC5W72iUFFa06SuuLpTlkXV69pOYCue0kvNaQnbz38OEUHOj3AW5mzn4FT1bZtk4Eo5KIRSaEq38K25zE3mxvsrsO4PoAhXWTOcatyxoyCzyH9WXGSS5KCE0WNDTLX+y/mMtw=="}
      } else {
        System.out.println("调用失败");
      }
    } catch (Exception e) {
      // TODO Auto-generated catch block
      e.printStackTrace();
    }
  }

1.5会员卡模板批量查询

备注:通过商户应用来查询商户下有多少template_id(template_id如果没有会员,则不显示;丢失只能重新创建),然后再通过2.4会员卡模板查询接口 查询每个模板的结构详情

 

1.文档地址:https://docs.open.alipay.com/api_5/alipay.marketing.card.template.batchquery

 

2.代码示例:

private void tempBatchQuery() {
    try {
     // 重新构建alipayClient,养成好的习惯,做到一劳永逸
      AlipayClient alipayClient = AlipayConfig.alipayClient();
      AlipayMarketingCardTemplateBatchqueryRequest request = new AlipayMarketingCardTemplateBatchqueryRequest();
      // page_no从1开始,不是0!!!
      request.setBizContent("{\"page_no\":1," + "\"page_size\":20}");
      AlipayMarketingCardTemplateBatchqueryResponse response = alipayClient.execute(request);
      if (response.isSuccess()) {
        System.out.println(response.getBody());
        
        //{"alipay_marketing_card_template_batchquery_response":{"code":"10000","msg":"Success","template_total":0},"sign":"SGsY5Wg0NIgUpD2+AXqQrKMbawJsyil7s6VvB4LyxVimKVEP4ltqgGq/GvYMoVlhDUAStoSG28IYWASe7wBdj23qA4IRymamhSmOO5fmqyVpdyDO5WWGjv3nGW93379vv9qvRe9mbehf/xBVeeO5ArKBhNjkFdEbiKVeP+u+m4dFG5jMyEeN9FCwA2QdHp2asROxrLIVzUiifmOpFsynWfWrAPXxB+HfmfdAHtLi+m60TCA1eJ6wu1o5lhXLufQcJWug+9wm8sdEX8t4EZKiUmwiyDyOtfstgsNLGQZ0KV30317eZhgzIPgse79bo0npbagFni4pSD0X0poyK9O9rA=="}
      } else {
        System.out.println("调用失败");
      }
    } catch (Exception e) {
      e.printStackTrace();
    }
  }

2.开卡表单接入

2.1会员卡开卡表单模板配置

备注:

开卡表单设置是一个很重要的接口,约定了商户要获取用户信息的哪些字段,目前支持字段如下:

(OPEN_FORM_FIELD_MOBILE -- 手机号 (敏感字段)

OPEN_FORM_FIELD_GENDER -- 性别 (常规字段)

OPEN_FORM_FIELD_NAME -- 姓名 (敏感字段)

OPEN_FORM_FIELD_BIRTHDAY -- 生日(不含年份,如:01-01) (敏感字段)

OPEN_FORM_FIELD_BIRTHDAY_WITH_YEAR -- 生日(含年份,如:1988-01-01) (敏感字段)

OPEN_FORM_FIELD_IDCARD -- 身份证 (敏感字段)

OPEN_FORM_FIELD_CERT_TYPE -- 证件类型 (敏感字段)

OPEN_FORM_FIELD_CERT_NO -- 证件号 (敏感字段)

OPEN_FORM_FIELD_EMAIL -- 邮箱 (敏感字段)

OPEN_FORM_FIELD_ADDRESS -- 地址 (敏感字段)

OPEN_FORM_FIELD_CITY -- 城市 (敏感字段)

OPEN_FORM_FIELD_IS_STUDENT -- 是否学生认证 (敏感字段)

OPEN_FORM_FIELD_MEMBER_GRADE -- 会员等级 (敏感字段)

 

Q:如何获取用户的敏感信息?

A:1.加入“蚂蚁数据安全与隐私保障联盟”的联盟成员可以使用“获取会员信息”功能包,在小程序场景在线申请开通获取会员信息(例如:手机号)的授权接口

      2.联盟成员需要严格遵守个人信息保护相关法律法规及监管要求,确保具备隐私保护及数据安全能力;联盟成员须遵守《蚂蚁开放平台用户信息处理规范》、《开放平台第三方应用安全开发指南》等规则,谨慎使用授权接口

      3.目前敏感信息暂不对个人账号开放

      4.用户的头像,昵称获取需要使用https://docs.open.alipay.com/api_2/alipay.user.info.share 接口获取

      5.用户的UID通过https://docs.open.alipay.com/api_9/alipay.system.oauth.token 接口获取

 

背景:随着支付宝的发展,用户注册支付宝只需要手机号,不在依赖用户的email,故此有部分用户的没有Email,故此我们在使用会员卡开卡表单模板配置时需要注意一下几点:

      在设置邮箱(OPEN_FORM_FIELD_EMAIL)字段是,务必将该字段放在optional(非必填字段),不能放在required(必填字段),如果设置required(必填字段)含有EMAIL,则没有Email的用户在开卡的情况,这种情况必须要求用户填写邮箱,如果用户不填写,则开不了。

备注:蜻蜓IOT设备,在用户输入EMAIL非常不便,如果想获取用户的邮箱,请将邮箱设置optional非必填字段

 

1.文档地址:https://docs.open.alipay.com/api_5/alipay.marketing.card.formtemplate.set

 

2.代码示例:

private void formtemplateSet() {
    try {
      AlipayClient alipayClient = AlipayConfig.alipayClient();

      AlipayMarketingCardFormtemplateSetRequest request = new AlipayMarketingCardFormtemplateSetRequest();
      request.setBizContent(
          "{\"template_id\":\"20190322000000001477341000300801\",\"fields\":{\"required\":{\"common_fields\":[\"OPEN_FORM_FIELD_MOBILE\",\"OPEN_FORM_FIELD_NAME\",\"OPEN_FORM_FIELD_GENDER\",\"OPEN_FORM_FIELD_BIRTHDAY_WITH_YEAR\",\"OPEN_FORM_FIELD_CITY\"]}}}");

      AlipayMarketingCardFormtemplateSetResponse response = alipayClient.execute(request);
      if (response.isSuccess()) {
        System.out.println(response.getBody());
        // {"alipay_marketing_card_formtemplate_set_response":{"code":"10000","msg":"Success"},"sign":"Mm3Z6nqvI2QXaqw5K6BZFIhxvzBYq+t2NFNSjk9riV1MOSSJm80os4uSw4fZ8HXvjJOpdANEY7gKes2Q3gjJQoautQefLLh9DRVrtxwx50mc0ZM4ctKy0HLNeDkvZH99luv2oMmsEZWG+PUf/rdEQZsHslfxl/7Szme1Fb3nMQYSgXOxWZlY3vYRu7B6g9RS6SKiUs7qXteZoUpL8ug8n6SBJUGwVAHB5iG3Dv1gf5CXhx1e0RNf+dLZ+1Xb2SdEtTOgZeE3gXsKS0DmPsC9h+pxJR5ZCSYTVm7msANfPd39SBQhtnKTrYg2Me+teWZUHeyIknwLbFjTnodNsQnCYg=="}

      } else {
        System.out.println("调用失败");
      }
    } catch (Exception e) {
      // TODO Auto-generated catch block
      e.printStackTrace();
    }
  }

 

2.2获取会员卡领卡投放链接

备注:小程序开卡不能传递callback字段,因为小程序本身没有授权回调地址,如果设定有callback字段,会报错ERR010 

1.文档地址:https://docs.open.alipay.com/api_5/alipay.marketing.card.activateurl.apply 

2.代码示例:

void activateurlApply() {
    try {
      AlipayClient alipayClient = AlipayConfig.alipayClient();
      AlipayMarketingCardActivateurlApplyRequest request = new AlipayMarketingCardActivateurlApplyRequest();
      request.setBizContent(
          "{" + "\"template_id\":\"20190322000000001477341000300801\"," + "\"out_string\":\"wufang\"}");

      AlipayMarketingCardActivateurlApplyResponse response = alipayClient.execute(request);
      if (response.isSuccess()) {
        System.out.println(response.getBody());
        // {"alipay_marketing_card_activateurl_apply_response":{"code":"10000","msg":"Success","apply_card_url":"https%3A%2F%2Fmemberprod.alipay.com%2Faccount%2Fopenform%2Factivecard.htm%3Fapp_id%3D2018121762595097%26template_id%3D20190322000000001477341000300801%26__webview_options__%3DcanPullDown%253dNO%2526transparentTitle%253dauto%26out_string%3Dwufang"},"sign":"S4B/hcySx90jbUI/SnEYAj3fxHaVVSFyFDKI+3NRDeT/KuMcA0FToqbEQ+xT517ejTMBbPdqe8akE5JcQHEX+Gapuzrc2jV60q8yPcnDDxsK+ykzvRLBLrfBe/CW/v7lpMyRJAIVi4LelpPPafIORQCzfotuq0OP6OF72rGKmX9skFFdxzTW7W3/h9XqH1XlB4U5xxTiHW5Unj/vnjoc/3LAmUa9YnC1vWlCYo6/WRyl0fzLKnpiknqLF4hFNrxjDgT22EWz2+Z/JVxoytk7+lEkm/auPET4v+JZ7HH1cqjBgHEV5N5enM9aYlwesl8CGIEIT0cF2V4SBF7aVF7aQg=="}
      } else {
        System.out.println("调用失败");
      }
    } catch (Exception e) {
      e.printStackTrace();
    }
  }

 

2.2.1小程序获取用户信息调用

1.IDE模块展示

1.1小程序写法
image.png

 

1.2会员卡js写法

备注:由于此方案为样例,在开发中,需要通过my.request将获取的res上传给服务端处理

 membershipcard_f() {
    my.addCardAuth({
      // url不能有callback参数,此url源于文档2.2
      url: 'https://memberprod.alipay.com/account/openform/activecard.htm?app_id=2018121762595097&template_id=20190322000000001477341000300801&__webview_options__=canPullDown%3dNO%26transparentTitle%3dauto&out_string=wufang',
      success: (res) => {
        console.log(res);
        my.alert({ content: '授权成功' });
      },
      fail: (res) => {
        my.alert({ content: '授权失败' });
      },
    });
  },

 

1.3真机调试

image.pngimage.pngimage.pngimage.png

 

2.3换取授权访问令牌

备注:通过2.2.1,获取的auth_code,获取用户访问令牌以及用户的USERID

1.1文档地址:https://docs.open.alipay.com/api_9/alipay.system.oauth.token

1.2代码示例:

private void oauthToken() {
    try {
      AlipayClient alipayClient = AlipayConfig.alipayClient();
      AlipaySystemOauthTokenRequest request = new AlipaySystemOauthTokenRequest();
      request.setGrantType("authorization_code");
      request.setCode("6a519c59c3814218b09a488601e7WX29");

      AlipaySystemOauthTokenResponse response = alipayClient.execute(request);
      if (response.isSuccess()) {
        System.out.println(response.getBody());
        //{"alipay_system_oauth_token_response":{"access_token":"composeB46cb24cc8f4d4ced9d52885d4d450X29","alipay_user_id":"20881072527331713126957952918029","expires_in":3600,"re_expires_in":3600,"refresh_token":"composeB1159f7c83f4b4a1e946e3225344cfF29","user_id":"2088302192982291"},"sign":"RHQ5oJdOyQzbaDJ4qE+SH12Y7dAvXVDdNCc6r0vIib0LDlXaqH7T7VdyuPNfFDcIuYDrHFXc5Ug96bh2Q5egoc5sPAfoTBqJboHfpbIKuy3D3Pm2jC1nMAKdQ/hrPHNqv6W7aqTHXvw9nMYqwaGZaLE0+yWuV7V9ZepnGSeLdUjVrXWVKZIFE6yOqwCGujsW5pwzHtVFfWHKPqiD9T5RnvP8aItQQLaf43gFrDHq7dtUV5VIzfVfMFQdQZQKHcGaQwJQOX0kd4NQIo5iseoPWFJLFWIBE/P2jEOe5XWbWVtTQsPfwDVDyPvDjGGGRjRtbLoTR18x0iQ5ONekIZdKXg=="}
      } else {
        System.out.println("调用失败");
      }
    } catch (Exception e) {
      e.printStackTrace();
    }
  }

 

2.4查询用户提交的会员卡表单信息

备注:该接口主要用于获取开卡表单里面设置的字段,字段见文档2.1备注

1.文档地址https://docs.open.alipay.com/api_5/alipay.marketing.card.activateform.query

2.代码示例:

private void activateformQuery() {
    try {
      AlipayClient alipayClient = AlipayConfig.alipayClient();

      AlipayMarketingCardActivateformQueryRequest request = new AlipayMarketingCardActivateformQueryRequest();
      //template_id 会员卡模板id
      //request_id 源自于2.2.1小程序返回的request_id
      request.setBizContent(
          "{\"biz_type\":\"MEMBER_CARD\",\"template_id\":\"20190322000000001477341000300801\",\"request_id\":\"20190325018631957594255530291\"}");
      AlipayMarketingCardActivateformQueryResponse response = alipayClient.execute(request,
          "composeB46cb24cc8f4d4ced9d52885d4d450X29");// 源自2.3获取的令牌
      if (response.isSuccess()) {
        System.out.println(response.getBody());
        //{"alipay_marketing_card_activateform_query_response":{"code":"10000","msg":"Success","infos":"[{\"OPEN_FORM_FIELD_BIRTHDAY_WITH_YEAR\":\"1990-06-01\"},{\"OPEN_FORM_FIELD_CITY\":\"杭州市\"},{\"OPEN_FORM_FIELD_GENDER\":\"男\"},{\"OPEN_FORM_FIELD_MOBILE\":\"186*****72\"},{\"OPEN_FORM_FIELD_NAME\":\"*海\"}]"},"sign":"Si7mVeTmWmOX09VPnTvId0H75qizQ8VYLa7TmuWzffbvv948EI020kWl41ACQ9KLKlGC6JhsfvsyqNiYTUvPGga2QbbAGGiH1wA5d8+D1SBnWaYR8GByY8GyzhrpY/hGdnyXiDR2j5FsynWEQudOnKUvoxGiQVxrUWuljB/09p82N8cxEF2GK2rUAfzP4CJSGYIa8LsWhDIcU8lON85gtmQz5wsyEjMBnVe8MINNTql0VAaTqZrJQ8tINKd/mz2jACVM8yAV/uIxzEnNxmkyCZsIVLNOxNQRORiGD5tV05poYKmbDIWzEachuco5q9r2HMSLZLMIFROkSLXB6s+YdA=="}
      } else {
        System.out.println("调用失败");
      }
    } catch (Exception e) {
      e.printStackTrace();
    }
  }

 

3.会员卡接入

3.1会员卡开卡

备注:通过2.3获取的访问令牌对用户进行开卡

1.文档地址:https://docs.open.alipay.com/api_5/alipay.marketing.card.open

2.代码示例:

 private void cardOpen() {
    try {

      AlipayClient alipayClient = AlipayConfig.alipayClient();
      AlipayMarketingCardOpenRequest request = new AlipayMarketingCardOpenRequest();
      request.setBizContent("{\"card_ext_info\":{\"open_date\":\"2019-03-25 00:00:01\",\"external_card_no\":\"10000001\",\"valid_date\":\"2099-02-20 21:20:46\"},\"card_template_id\":\"20190322000000001477341000300801\",\"card_user_info\":{\"user_uni_id\":\"2088302192982291\",\"user_uni_id_type\":\"UID\"},\"member_ext_info\":{\"birth\":\"1990-06-01\",\"name\":\"*海\"},\"out_serial_no\":\"2018032512345\"}");
      AlipayMarketingCardOpenResponse response = alipayClient.execute(request,
          "composeBb11e231b0cfa4e69b6273598b245aB29");
      if (response.isSuccess()) {
        System.out.println(response.getBody());
        //{"alipay_marketing_card_open_response":{"code":"10000","msg":"Success","card_info":{"biz_card_no":"pre0000000929","external_card_no":"10000001","open_date":"2019-03-25 00:00:01","valid_date":"2099-02-20 21:20:46"}},"sign":"EXTPdoYac5xoZjjkFb5/fmiU4ZkO0YzezH/xsqCGTK3KULzZ2AdOXw4lj6rAHrIATHoTYVDcGfEYxwy5BjbnxCYyegJPTsUZjB0UhqRSs12aI/LUZiFGGNV+g6yJclgBkwSToqHznzgsKablLCblqJiynDbSg+uo8a0phvAFcRS9rbpx9wj8CAVy0WTkfi4LGVYsk4ZhKah6AcIwC3Pf95DGoyd5gKp5gjt09GZbzjQN1cX8VZfavWcQWaMI5DnZCA0UI3BHDSN53fr8lVu7VeKVTaeDMO24QR2VZU98uswwsLNwj574Ea9KLczGCLrgGxLsszTGHjqZHw77u/6EzA=="}
      } else {
        System.out.println("调用失败");
      }
    } catch (Exception e) {
      // TODO Auto-generated catch block
      e.printStackTrace();
    }
  }

 

3.效果示例:


image.png

 

3.2会员卡更新

1.文档地址:https://docs.open.alipay.com/api_5/alipay.marketing.card.update

3.3会员卡删卡

1.文档地址:https://docs.open.alipay.com/api_5/alipay.marketing.card.delete

3.4会员卡查询

1.文档地址:https://docs.open.alipay.com/api_5/alipay.marketing.card.query

FAQ

关于此文档暂时还没有FAQ
返回
顶部