Skip to content

Commit a8bac13

Browse files
yuanqixunbinarywang
yuanqixun
authored and
binarywang
committed
binarywang#739 增加微信激活会员卡时需要用的设置用户资料的接口
 * 增加微信激活会员卡，设置用户资料字段接口实现。 * 增加创建卡券二维码的失效时间参数接口。 * 设置对象返回类型。 * 增加卡券相关事件及xml消息解析
1 parent 4dd67f4 commit a8bac13

19 files changed

Lines changed: 537 additions & 17 deletions

‎weixin-java-common/src/main/java/me/chanjar/weixin/common/api/WxConsts.java‎

Lines changed: 72 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -82,7 +82,7 @@ public static class KefuMsgType {
8282
/**
8383
* 小程序卡片(要求小程序与公众号已关联)
8484
*/
85-
public static final String MINIPROGRAMPAGE="miniprogrampage";
85+
public static final String MINIPROGRAMPAGE = "miniprogrampage";
8686
}
8787

8888
/**
@@ -181,6 +181,76 @@ public static class EventType {
181181
* 微信小店 订单付款通知.
182182
*/
183183
public static final String MERCHANT_ORDER = "merchant_order";
184+
185+
/**
186+
* 卡券事件：卡券通过审核
187+
*/
188+
public static final String CARD_PASS_CHECK = "card_pass_check";
189+
190+
/**
191+
* 卡券事件：卡券未通过审核
192+
*/
193+
public static final String CARD_NOT_PASS_CHECK = "card_not_pass_check";
194+
195+
/**
196+
* 卡券事件：用户领取卡券
197+
*/
198+
public static final String CARD_USER_GET_CARD = "user_get_card";
199+
200+
/**
201+
* 卡券事件：用户转赠卡券
202+
*/
203+
public static final String CARD_USER_GIFTING_CARD = "user_gifting_card";
204+
205+
206+
/**
207+
* 卡券事件：用户核销卡券
208+
*/
209+
public static final String CARD_USER_CONSUME_CARD = "user_consume_card";
210+
211+
212+
/**
213+
* 卡券事件：用户通过卡券的微信买单完成时推送
214+
*/
215+
public static final String CARD_USER_PAY_FROM_PAY_CELL = "user_pay_from_pay_cell";
216+
217+
218+
/**
219+
* 卡券事件：用户提交会员卡开卡信息
220+
*/
221+
public static final String CARD_SUBMIT_MEMBERCARD_USER_INFO = "submit_membercard_user_info";
222+
223+
/**
224+
* 卡券事件：用户打开查看卡券
225+
*/
226+
public static final String CARD_USER_VIEW_CARD = "user_view_card";
227+
228+
/**
229+
* 卡券事件：用户删除卡券
230+
*/
231+
public static final String CARD_USER_DEL_CARD = "user_del_card";
232+
233+
/**
234+
* 卡券事件：用户在卡券里点击查看公众号进入会话时（需要用户已经关注公众号）
235+
*/
236+
public static final String CARD_USER_ENTER_SESSION_FROM_CARD = "user_enter_session_from_card";
237+
238+
/**
239+
* 卡券事件：当用户的会员卡积分余额发生变动时
240+
*/
241+
public static final String CARD_UPDATE_MEMBER_CARD = "update_member_card";
242+
243+
/**
244+
* 卡券事件：当某个card_id的初始库存数大于200且当前库存小于等于100时，用户尝试领券会触发发送事件给商户，事件每隔12h发送一次
245+
*/
246+
public static final String CARD_SKU_REMIND = "card_sku_remind";
247+
248+
/**
249+
* 卡券事件：当商户朋友的券券点发生变动时
250+
*/
251+
public static final String CARD_PAY_ORDER = "card_pay_order";
252+
253+
184254
}
185255

186256
/**
@@ -280,4 +350,5 @@ public static class MaterialType {
280350
public static final String IMAGE = "image";
281351
public static final String VIDEO = "video";
282352
}
353+
283354
}

‎weixin-java-mp/src/main/java/me/chanjar/weixin/mp/api/WxMpCardService.java‎

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -145,6 +145,15 @@ void markCardCode(String code, String cardId, String openId, boolean isMark) thr
145145
*/
146146
WxMpCardQrcodeCreateResult createQrcodeCard(String cardId, String outerStr) throws WxErrorException;
147147

148+
/**
149+
* 创建卡券二维码
150+
* @param cardId 卡券编号
151+
* @param outerStr 二维码标识
152+
* @param expiresIn 失效时间，单位秒，不填默认365天
153+
* @return WxMpCardQrcodeCreateResult
154+
*/
155+
WxMpCardQrcodeCreateResult createQrcodeCard(String cardId, String outerStr,int expiresIn) throws WxErrorException;
156+
148157
/**
149158
* 创建卡券货架
150159
* @param createRequest 货架创建参数

‎weixin-java-mp/src/main/java/me/chanjar/weixin/mp/api/WxMpMemberCardService.java‎

Lines changed: 26 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,17 +1,28 @@
11
package me.chanjar.weixin.mp.api;
22

33
import me.chanjar.weixin.common.error.WxErrorException;
4+
import me.chanjar.weixin.mp.bean.card.MemberCardActivateUserFormRequest;
5+
import me.chanjar.weixin.mp.bean.card.MemberCardActivateUserFormResult;
46
import me.chanjar.weixin.mp.bean.card.WxMpCardCreateResult;
5-
import me.chanjar.weixin.mp.bean.card.WxMpCardQrcodeCreateResult;
67
import me.chanjar.weixin.mp.bean.membercard.*;
78

89
/**
910
* 会员卡相关接口
1011
*
11-
* @author YuJian([email protected])
12+
* @author YuJian(mgcnrx11 @ gmail.com)
13+
* @author yuanqixun
1214
* @version 2017/7/8
15+
* @date 2018-08-30
1316
*/
1417
public interface WxMpMemberCardService {
18+
String MEMBER_CARD_CREAET = "https://api.weixin.qq.com/card/create";
19+
String MEMBER_CARD_ACTIVATE = "https://api.weixin.qq.com/card/membercard/activate";
20+
String MEMBER_CARD_USER_INFO_GET = "https://api.weixin.qq.com/card/membercard/userinfo/get";
21+
String MEMBER_CARD_UPDATE_USER = "https://api.weixin.qq.com/card/membercard/updateuser";
22+
/**
23+
* 会员卡激活之微信开卡接口(wx_activate=true情况调用)
24+
*/
25+
String MEMBER_CARD_ACTIVATEUSERFORM = "https://api.weixin.qq.com/card/membercard/activateuserform/set";
1526

1627
/**
1728
* 得到WxMpService
@@ -20,6 +31,7 @@ public interface WxMpMemberCardService {
2031

2132
/**
2233
* 会员卡创建接口
34+
*
2335
* @param createJson
2436
* @return
2537
* @throws WxErrorException
@@ -28,6 +40,7 @@ public interface WxMpMemberCardService {
2840

2941
/**
3042
* 会员卡创建接口
43+
*
3144
* @param createMessageMessage
3245
* @return WxMpCardCreateResult
3346
* @throws WxErrorException
@@ -47,15 +60,15 @@ public interface WxMpMemberCardService {
4760
* 拉取会员信息接口
4861
*
4962
* @param cardId 会员卡的CardId，微信分配
50-
* @param code 领取会员的会员卡Code
63+
* @param code 领取会员的会员卡Code
5164
* @return 会员信息的结果对象
5265
* @throws WxErrorException 接口调用失败抛出的异常
5366
*/
5467
WxMpMemberCardUserInfoResult getUserInfo(String cardId, String code) throws WxErrorException;
5568

5669
/**
5770
* 当会员持卡消费后，支持开发者调用该接口更新会员信息。会员卡交易后的每次信息变更需通过该接口通知微信，便于后续消息通知及其他扩展功能。
58-
*
71+
* <p>
5972
* 1.开发者可以同时传入add_bonus和bonus解决由于同步失败带来的幂等性问题。同时传入add_bonus和bonus时
6073
* add_bonus作为积分变动消息中的变量值，而bonus作为卡面上的总积分额度显示。余额变动同理。
6174
* 2.开发者可以传入is_notify_bonus控制特殊的积分对账变动不发送消息，余额变动同理。
@@ -66,4 +79,13 @@ public interface WxMpMemberCardService {
6679
*/
6780
WxMpMemberCardUpdateResult updateUserMemberCard(WxMpMemberCardUpdateMessage updateUserMessage) throws WxErrorException;
6881

82+
/**
83+
* 设置会员卡激活的字段（会员卡设置：wx_activate=true 时需要）
84+
*
85+
* @param userFormRequest
86+
* @return
87+
* @throws WxErrorException
88+
*/
89+
MemberCardActivateUserFormResult setActivateUserForm(MemberCardActivateUserFormRequest userFormRequest) throws WxErrorException;
90+
6991
}

‎weixin-java-mp/src/main/java/me/chanjar/weixin/mp/api/impl/WxMpCardServiceImpl.java‎

Lines changed: 18 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -256,14 +256,29 @@ public String addTestWhiteList(String openid) throws WxErrorException {
256256

257257
/**
258258
* 创建卡券二维码
259+
*
259260
* @param cardId
260261
* @param outerStr
261262
* @return
262263
*/
263264
public WxMpCardQrcodeCreateResult createQrcodeCard(String cardId, String outerStr) throws WxErrorException {
265+
return createQrcodeCard(cardId, outerStr, 0);
266+
}
267+
268+
/**
269+
* 创建卡券二维码
270+
* @param cardId 卡券编号
271+
* @param outerStr 二维码标识
272+
* @param expiresIn 失效时间，单位秒，不填默认365天
273+
* @return
274+
* @throws WxErrorException
275+
*/
276+
public WxMpCardQrcodeCreateResult createQrcodeCard(String cardId, String outerStr, int expiresIn) throws WxErrorException {
264277
JsonObject jsonObject = new JsonObject();
265278
jsonObject.addProperty("action_name", "QR_CARD");
266-
jsonObject.addProperty("expire_seconds", 1800);
279+
if (expiresIn > 0) {
280+
jsonObject.addProperty("expire_seconds", expiresIn);
281+
}
267282
JsonObject actionInfoJson = new JsonObject();
268283
JsonObject cardJson = new JsonObject();
269284
cardJson.addProperty("card_id", cardId);
@@ -276,13 +291,14 @@ public WxMpCardQrcodeCreateResult createQrcodeCard(String cardId, String outerSt
276291

277292
/**
278293
* 创建卡券货架接口
294+
*
279295
* @param request
280296
* @return
281297
* @throws WxErrorException
282298
*/
283299
@Override
284300
public WxMpCardLandingPageCreateResult createLandingPage(WxMpCardLandingPageCreateRequest request) throws WxErrorException {
285-
String response = this.wxMpService.post(CARD_LANDING_PAGE_CREAET,GSON.toJson(request));
301+
String response = this.wxMpService.post(CARD_LANDING_PAGE_CREAET, GSON.toJson(request));
286302
return WxMpCardLandingPageCreateResult.fromJson(response);
287303
}
288304
}

‎weixin-java-mp/src/main/java/me/chanjar/weixin/mp/api/impl/WxMpMemberCardServiceImpl.java‎

Lines changed: 20 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,12 +1,18 @@
11
package me.chanjar.weixin.mp.api.impl;
22

3-
import com.google.gson.*;
3+
import com.google.gson.Gson;
4+
import com.google.gson.JsonElement;
5+
import com.google.gson.JsonObject;
6+
import com.google.gson.JsonParser;
47
import com.google.gson.reflect.TypeToken;
58
import me.chanjar.weixin.common.error.WxErrorException;
69
import me.chanjar.weixin.common.util.json.WxGsonBuilder;
710
import me.chanjar.weixin.mp.api.WxMpMemberCardService;
811
import me.chanjar.weixin.mp.api.WxMpService;
912
import me.chanjar.weixin.mp.bean.card.*;
13+
import me.chanjar.weixin.mp.bean.card.enums.BusinessServiceType;
14+
import me.chanjar.weixin.mp.bean.card.enums.CardColor;
15+
import me.chanjar.weixin.mp.bean.card.enums.DateInfoType;
1016
import me.chanjar.weixin.mp.bean.membercard.*;
1117
import me.chanjar.weixin.mp.util.json.WxMpGsonBuilder;
1218
import org.apache.commons.lang3.StringUtils;
@@ -23,11 +29,6 @@ public class WxMpMemberCardServiceImpl implements WxMpMemberCardService {
2329

2430
private final Logger log = LoggerFactory.getLogger(WxMpMemberCardServiceImpl.class);
2531

26-
private static final String MEMBER_CARD_CREAET = "https://api.weixin.qq.com/card/create";
27-
private static final String MEMBER_CARD_ACTIVATE = "https://api.weixin.qq.com/card/membercard/activate";
28-
private static final String MEMBER_CARD_USER_INFO_GET = "https://api.weixin.qq.com/card/membercard/userinfo/get";
29-
private static final String MEMBER_CARD_UPDATE_USER = "https://api.weixin.qq.com/card/membercard/updateuser";
30-
3132
private WxMpService wxMpService;
3233

3334
private static final Gson GSON = new Gson();
@@ -265,4 +266,17 @@ public WxMpMemberCardUpdateResult updateUserMemberCard(WxMpMemberCardUpdateMessa
265266
}.getType());
266267
}
267268

269+
/**
270+
* 设置会员卡激活的字段（会员卡设置：wx_activate=true 时需要）
271+
*
272+
* @param userFormRequest
273+
* @return
274+
* @throws WxErrorException
275+
*/
276+
@Override
277+
public MemberCardActivateUserFormResult setActivateUserForm(MemberCardActivateUserFormRequest userFormRequest) throws WxErrorException {
278+
String responseContent = this.getWxMpService().post(MEMBER_CARD_ACTIVATEUSERFORM, GSON.toJson(userFormRequest));
279+
return MemberCardActivateUserFormResult.fromJson(responseContent);
280+
}
281+
268282
}

‎weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/card/AdvancedInfo.java‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,7 @@
22

33
import com.google.gson.annotations.SerializedName;
44
import lombok.Data;
5+
import me.chanjar.weixin.mp.bean.card.enums.BusinessServiceType;
56
import org.apache.commons.lang3.builder.ToStringBuilder;
67
import org.apache.commons.lang3.builder.ToStringStyle;
78

‎weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/card/MemberCardActivateUserFormRequest.java‎

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
package me.chanjar.weixin.mp.bean.card;
2+
3+
import com.google.gson.JsonObject;
4+
import com.google.gson.annotations.SerializedName;
5+
import lombok.Data;
6+
import org.apache.commons.lang3.StringUtils;
7+
8+
import java.io.Serializable;
9+
10+
/**
11+
* 会员卡激活，用户字段提交请求
12+
*
13+
* @author yuanqixun
14+
* @date 2018-08-30
15+
*/
16+
@Data
17+
public class MemberCardActivateUserFormRequest implements Serializable {
18+
@SerializedName("card_id")
19+
private String cardId;
20+
21+
@SerializedName("service_statement")
22+
private JsonObject serviceStatement;
23+
24+
@SerializedName("bind_old_card")
25+
private JsonObject bindOldCard;
26+
27+
/**
28+
* 必填项
29+
*/
30+
@SerializedName("required_form")
31+
private MemberCardUserForm requiredForm;
32+
33+
/**
34+
* 可选项
35+
*/
36+
@SerializedName("optional_form")
37+
private MemberCardUserForm optionalForm;
38+
39+
/**
40+
* 绑定老会员卡信息
41+
*
42+
* @param name
43+
* @param url
44+
*/
45+
public void setBindOldCard(String name, String url) {
46+
if (StringUtils.isAnyEmpty(name, url)) {
47+
return;
48+
}
49+
if (bindOldCard == null)
50+
bindOldCard = new JsonObject();
51+
bindOldCard.addProperty("name", name);
52+
bindOldCard.addProperty("url", url);
53+
}
54+
55+
/**
56+
* 设置服务声明，用于放置商户会员卡守则
57+
*
58+
* @param name
59+
* @param url
60+
*/
61+
public void setServiceStatement(String name, String url) {
62+
if (StringUtils.isAnyEmpty(name, url)) {
63+
return;
64+
}
65+
if (serviceStatement == null)
66+
serviceStatement = new JsonObject();
67+
serviceStatement.addProperty("name", name);
68+
serviceStatement.addProperty("url", url);
69+
}
70+
}

‎weixin-java-mp/src/main/java/me/chanjar/weixin/mp/bean/card/MemberCardActivateUserFormResult.java‎

Lines changed: 29 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
package me.chanjar.weixin.mp.bean.card;
2+
3+
import lombok.Data;
4+
import me.chanjar.weixin.mp.util.json.WxMpGsonBuilder;
5+
import org.apache.commons.lang3.builder.ToStringBuilder;
6+
import org.apache.commons.lang3.builder.ToStringStyle;
7+
8+
import java.io.Serializable;
9+
10+
@Data
11+
public class MemberCardActivateUserFormResult implements Serializable {
12+
private Integer errcode;
13+
private String errmsg;
14+
15+
public boolean isSuccess() {
16+
return 0 == errcode;
17+
}
18+
19+
public static MemberCardActivateUserFormResult fromJson(String json) {
20+
return WxMpGsonBuilder.create().fromJson(json, MemberCardActivateUserFormResult.class);
21+
}
22+
23+
@Override
24+
public String toString() {
25+
return ToStringBuilder.reflectionToString(this, ToStringStyle.JSON_STYLE);
26+
}
27+
28+
}
29+

0 commit comments

Comments
 (0)