支付宝六(商户会员卡之模板创建)
来源:互联网 发布:sony系统更新挂起网络 编辑:程序博客网 时间:2024/04/29 16:16
商户会员卡模板创建一直持续了大半个月的时间,天天与支付宝的技术进行沟通,终于创建成功了,这里Mark一下。
1. 构建模板参数
下面的模板参数中,有许多前面加了注释符号,基本都是可选参数,而且容易导致报 “入参错误” 的参数,如果您有需要,请自行尝试或联系支付宝技术客服。
/** * @todo: 组建 会员卡模板 相关参数数组 * @return array */public function addMarketCardJson(){$json_data = array();$json_data['request_id'] = date('YmdHis').mt_rand(10000,99999);$json_data['card_type'] = 'OUT_MEMBER_CARD';$json_data['biz_no_prefix'] = 'prex';$json_data['biz_no_suffix_len'] = '10';$json_data['write_off_type'] = 'qrcode'; #qrcode: 二维码 dqrcode: 动态二维码 barcode: 条码 dbarcode: 动态条码 text: 文本$json_data['template_style_info']['card_show_name'] = '高端会员卡';$json_data['template_style_info']['logo_id'] = 'YS6zsqoES5iHcD4uGwrP6QAAACMAAQED'; # logo 上传后的ID 1M以内,格式bmp、png、jpeg、jpg、gif; 尺寸不小于500*500px的正方形; 请优先使用商家LOGO;$json_data['template_style_info']['color'] = 'rgb(55,112,179)'; #卡片背景色$json_data['template_style_info']['background_id'] = '1BPt1AVNQnGAkntb2PFw3QAAACMAAQED'; # 上传背景图片返回的ID$json_data['template_style_info']['bg_color'] = 'rgb(153,204,153)'; # 背景色 #$json_data['template_style_info']['feature_descriptions'] = array('使用高端会员卡,0门卡享受9折优惠') ; # √ 描述 #$json_data['template_style_info']['slogan'] = '会员权益享不停'; # √ 标语 #$json_data['template_style_info']['slogan_img_id'] = '1BPt1AVNQnGAkntb2PFw3QAAACMAAQED'; # √ 标语图片ID #$json_data['template_style_info']['brand_name'] = '高端会员'; # √ 品牌名称$json_data['template_benefit_info'] = array( # √ 权益信息, 1、在卡包的卡详情页面会自动添加权益栏位,展现会员卡特权, 2、如果添加门店渠道,则可在门店页展现会员卡的权益array('title' => '消费即折扣1', # 权益标题'benefit_desc' => ['消费即折扣2'], # 权益描述'start_date' => '2016-07-18 15:17:23', # 权益开始时间'end_date' => '2017-07-18 15:17:23', # 权益结束时间) );$json_data['column_info_list'] = array(array('code' => 'BENEFIT_INFO', # code 唯一码 写死'more_info' => array('title' => '会员专享权益', # 二级页面标题√'url' => BASE_DOMAIN, # 超链接(选择openweb的时候必须填写url参数内容)√'params' => '{}', # 需要URL地址回带的值,JSON格式(openweb时填)√ # 'descs' => ['会员生日打六折'] # 选择opennative的时候必须填写descs的内容√),'title' => '进入店铺', # 栏目标题'operate_type' => 'openWeb', # 1、openNative:打开二级页面,展现 more中descs 2、openWeb:打开URL 3、staticinfo:静态信息// 'value' => '80' , # 卡包详情页面,卡栏位右边展现的值√) );$json_data['field_rule_list'] = array(array('field_name' => 'Balance', # Balance:金额 Point:整数 Level:任意字符串 OpenDate:开卡日期 ValidDate:过期日期'rule_name' => 'ASSIGN_FROM_REQUEST', # 1.ASSIGN_FROM_REQUEST: 以rule_value为key值,表示该栏位的值从会员卡开卡接口中获取,会员卡开卡接口的card_info中获取对应参数值 # 2、DATE_IN_FUTURE: 生成一个未来的日期(格式YYYY-MM-DD),当选择DATE_IN_FUTURE的时候,field_name 必须是OpenDate或ValidDate, 值为(10m或10d 分别表示10个月或10天) # 3、CONST: 常量,会员卡开卡接口进行开卡的时候使用模板创建时候设置的值,即取rule_value的值'rule_value' => 'Balance' # 根据rule_name,采取相应取值策略 # 3.CONST:直接取rule_value作为卡属性值 # 3.DATE_IN_FUTURE:10m或10d 分别表示10个月或10天 # 1.ASSIGN_FROM_REQUEST:在开卡Reuqest请求中按rule_value取值,现在和field_name对应的为(OpenDate、ValidDate、Level、Point、Balance)),/* array( 'field_name' => 'Point', 'rule_name' => 'ASSIGN_FROM_REQUEST', 'rule_value' => 'Point' ), array( 'field_name' => 'Level', 'rule_name' => 'CONST', 'rule_value' => '1' ), array( 'field_name' => 'OpenDate', 'rule_name' => 'DATE_IN_FUTURE', 'rule_value' => '0d' ), array( 'field_name' => 'ValidDate', 'rule_name' => 'DATE_IN_FUTURE', 'rule_value' => '12m' )*/);// $json_data['open_card_conf'] = array( # √// 'open_card_source_type' => 'ISV', #ISV:外部系统 MER:直连商户// 'source_app_id' => '2016101702200000', # 渠道APPID,提供领卡页面的服务提供方// 'open_card_url' => BASE_DOMAIN, # 开卡连接,必须http、https开头// #'conf' => '' , # √ 配置,预留字段,暂时不用// );// $json_data['service_label_list'] = ['HUABEI_FUWU'] ; # √ 服务Code HUABEI_FUWU:花呗服务(只有需要花呗服务时,才需要加入该标识)// $json_data['shop_ids'] = []; # √ 会员卡上架门店id(支付宝门店id),既发放会员卡的商家门店id// $json_data['pub_channels'] = array( # √ 卡模板投放渠道// array(// 'pub_channel' => 'SHOP_DETAIL' , # 1、SHOP_DETAIL:店铺详情页 2、PAYMENT_RESULT: 支付成功页(支付成功页暂不支持)// 'ext_info' => '{}' # 扩展信息,无需配置 "key":"value"// )// );#card_level_conf 这个参数 有问题 请勿添加// $json_data['card_level_conf'] = array( # √ 卡级别配置// array(// 'level' => 'VIP3', # 会员级别 该级别和开卡接口中的levle要一致// 'level_show_name' => '黄金会员', # 会员级别显示名称// 'level_icon' => 'aPQKWaYXQZimxEFz09nTBQAAACMAAQED',# 会员级别对应icon, 通过接口(alipay.offline.material.image.upload)上传图片// 'level_desc' => '黄金会员享受免费停车,加油85折', # 会员级别描述// ),// array(//// 'level' => 'VIP2',//// 'level_show_name' => '银牌会员',//// 'level_icon' => 'rIBh_U4IRfmJtP97b-M5QQAAACMAAQED',//// 'level_desc' => '银牌会员享受免费停车,加油9折',// ),// array( //// 'level' => 'VIP1',//// 'level_show_name' => '铁牌会员',//// 'level_icon' => 'U1GnhAh8QNGJxkBcBADyQAAAACMAAQED',//// 'level_desc' => '铁牌会员享受免费停车,加油9折',// )// );return $json_data;
2. 创建会员卡模板
这里有一个已经成功的 json 模板例子,可以尝试一下 ,可能有些人用不了,不知道原因,不过我这里成功了
PHP在转json的过程中 可以将中文字符不转义,注意支付宝的 文档中
#会员卡 模板创建public function addMarketCardTemplete(){$this->AopClient->gatewayUrl = 'https://openapi.alipay.com/gateway.do';$this->AopClient->apiVersion = '1.0';$request = new AlipayMarketingCardTemplateCreateRequest();$post_data = $this->addMarketCardJson();$post_data = json_encode($post_data,JSON_UNESCAPED_UNICODE);/* 正常请求成功数据 请更改 request_id 值 再请求 $post_data = '{ "request_id": "124678911122", "card_type": "OUT_MEMBER_CARD", "biz_no_prefix": "prex", "biz_no_suffix_len": "8", "write_off_type": "qrcode", "template_style_info": { "card_show_name": "高端会员卡", "logo_id": "tLuK85s3SnKSiagmulHBUwAAACMAAQQD", "color": "rgb(55,112,179)", "background_id": "tLuK85s3SnKSiagmulHBUwAAACMAAQQD", "bg_color": "rgb(55,112,179)" }, "field_rule_list": [ { "field_name": "Balance", "rule_name": "ASSIGN_FROM_REQUEST", "rule_value": "Balance" } ], "column_info_list": [ { "code": "BENEFIT_INFO", "more_info": { "title": "会员专享权益", "url": "http://www.baidu.com", "params": "{}" }, "title": "会员专享", "operate_type": "openWeb" } ], "template_benefit_info": [ { "title": "消费即折扣", "benefit_desc": [ "消费即折扣" ], "start_date": "2016-07-18 15:17:23", "end_date": "2017-07-34 12:12:12" } ]}';*/$request->setBizContent($post_data);$result = $this->AopClient->execute($request);$responseNode = str_replace(".", "_", $request->getApiMethodName()) . "_response";$resultCode = $result->$responseNode->code;if(!empty($resultCode)&&$resultCode == 10000){echo "成功";} else {echo "失败";} }
创建成功返回结果
{"alipay_marketing_card_template_create_response":{"code":"10000","msg":"Success","template_id":"20161207000000000099121000300xxx"},"sign":"DsXWiJsQOPhWC77Tls4d4UicLE0on5o60y5o2S4uRKaP4Br8ojPT4FY+bdj5MN5k/J5OS2ypnDdBvHOyo3U5Z/tpmdWpxRgphiE7OLO+8PXOCYOU9Jh+OThk/KQYJqPbC/o5FSRRDeZ7PUBbwLVnZHolQMxP/emi5JFyMEYDIA8="}
3. 会员卡更新模板
#会员卡 模板更新public function updateMarketCardTemplete(){$this->AopClient->gatewayUrl = 'https://openapi.alipay.com/gateway.do';$this->AopClient->apiVersion = '1.0';$request = new AlipayMarketingCardTemplateModifyRequest();$post_data = $this->addMarketCardJson();$post_data['template_id'] = '2016120700000000009912100030xxxx';$post_data['request_id'] = '124678911122';$post_data['write_off_type'] ='barcode';unset($post_data['card_type']); #更新模板不需要此参数unset($post_data['biz_no_suffix_len']); #更新模板不需要此参数$post_data = json_encode($post_data,JSON_UNESCAPED_UNICODE);$request->setBizContent($post_data);$result = $this->AopClient->execute($request);$responseNode = str_replace(".", "_", $request->getApiMethodName()) . "_response";$resultCode = $result->$responseNode->code;if(!empty($resultCode)&&$resultCode == 10000){echo "成功";} else {echo "失败";} }
修改成功返回结果
{"alipay_marketing_card_template_modify_response":{"code":"10000","msg":"Success","template_id":"20161207000000000099121000300xxx"},"sign":"DsXWiJsQOPhWC77Tls4d4UicLE0on5o60y5o2S4uRKaP4Br8ojPT4FY+bdj5MN5k/J5OS2ypnDdBvHOyo3U5Z/tpmdWpxRgphiE7OLO+8PXOCYOU9Jh+OThk/KQYJqPbC/o5FSRRDeZ7PUBbwLVnZHolQMxP/emi5JFyMEYDIA8="}
4. 会员卡模板查询
#会员卡 模板查询public function queryMarketCardTemplete(){$this->AopClient->gatewayUrl = 'https://openapi.alipay.com/gateway.do';$this->AopClient->apiVersion = '1.0';$request = new AlipayMarketingCardTemplateQueryRequest();$post_data['template_id'] = '201612070000000001031170003XXXX';$post_data = json_encode($post_data,JSON_UNESCAPED_UNICODE);$request->setBizContent($post_data);$result = $this->AopClient->execute($request);$responseNode = str_replace(".", "_", $request->getApiMethodName()) . "_response";$resultCode = $result->$responseNode->code;if(!empty($resultCode)&&$resultCode == 10000){echo "成功";} else {echo "失败";} }# ----------------------------------------会员卡模板部分结束---------------------------------------------------------
返回结果
{"alipay_marketing_card_template_query_response":{"code":"10000","msg":"Success","biz_no_prefix":"prex","biz_no_suffix_len":"10","card_type":"OUT_MEMBER_CARD","column_info_list":[{"code":"BENEFIT_INFO","more_info":{"params":"{}","title":"会员专享权益","url":"http:\/\/testshop1.ouyun.com\/"},"operate_type":"openWeb","title":"进入店铺"}],"field_rule_list":[{"field_name":"Balance","rule_name":"ASSIGN_FROM_REQUEST","rule_value":"Balance"}],"template_benefit_info":[{"benefit_desc":["消费即折扣2"],"end_date":"2017-07-18 15:17:23","start_date":"2016-07-18 15:17:23","title":"消费即折扣1"}],"template_style_info":{"background_id":"1BPt1AVNQnGAkntb2PFw3QAAACMAAQED","bg_color":"rgb(153,204,153)","card_show_name":"高端会员卡","color":"rgb(55,112,179)","logo_id":"YS6zsqoES5iHcD4uGwrP6QAAACMAAQED"}},"sign":"onpHp4PQr6hOsbRGrbM+B5h8o1xG7Ny"}
支付宝文档 部分示例 有问题 其中 json部分参数错误
https://doc.open.alipay.com/docs/api.htm?docType=4&apiId=1192
【注意】
支付宝文档中 card_level_conf 这个示例参数 是个多维数组 json 时 需要 {[{等级1},{等级2},{等级3}]} 否则会报 “入参格式错误”,还有些可选的参数也会报此错误,尽量减少可选参数。
1 0
- 支付宝六(商户会员卡之模板创建)
- 支付宝七(商户会员卡之发放卡券)
- 会员卡管理系统技术解析(六) 会员卡退卡
- 关于支付宝商户(蚂蚁金服)api调用
- 商户入网第三方支付——易宝之PC端支付流程
- 会员卡管理系统技术解析(六)登陆与注册之注册
- 支付宝无线商户签约指南
- 商户端 和 支付宝 通讯验证
- 微信支付-商户后台(1)
- 微信支付-商户后台(2)
- 微信支付-商户后台(3)
- 微信支付-商户后台(4)
- 六、创建Templates(模板)
- 微信开发之微信支付(商户平台提供的方式)
- 商户PC端接入支付宝支付(java)
- 初始商户信息导入(下载模板)
- 微信商户开发文档之扫码支付
- 支付宝商户收款二维码在哪里?怎么开通商户收款吗
- C 内存分配
- 设计模式之代理模式
- 设置按钮上的文字靠左靠右居中显示
- Codeforces 264A Buggy Sorting(童年排序)
- typeof与instanceof
- 支付宝六(商户会员卡之模板创建)
- CVPR 2016-12-06
- PHP高效率写法(详解原因)
- 精确查找 -sed
- 遍历ul下的li的点击事件给予class样式属性
- Java中引入泛型的好处
- C++之构造函数(二) 构造函数初始化
- 开源RTP/RTCP传输库jrtplib与live555优缺点简单总结笔记
- Arrays.asList方法概括