diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/ComplaintDetailResult.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/ComplaintDetailResult.java index 157e095bb..f8562dce3 100644 --- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/ComplaintDetailResult.java +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/ComplaintDetailResult.java @@ -327,4 +327,141 @@ public class ComplaintDetailResult implements Serializable { */ @SerializedName("user_tag_list") private String[] userTagList; + + /** + *
+ * 字段名:补充信息 + * 是否必填:否 + * 描述: 用在特定行业或场景下返回的补充信息 + *+ */ + @SerializedName("additional_info") + private AdditionalInfo additionalInfo; + + @Data + public static class AdditionalInfo implements Serializable { + private static final long serialVersionUID = 7917816070738944147L; + + /** + *
+ * 字段名:补充信息类型 + * 是否必填:否 + * 描述: 补充信息类型 + * 示例值:SHARE_POWER_TYPE: 充电宝投诉相关行业 + *+ */ + @SerializedName("type") + private String type; + + /** + *
+ * 字段名:充电宝投诉相关信息 + * 是否必填:否 + * 描述:当type为充电宝投诉相关时有值 + *+ */ + @SerializedName("share_power_info") + private SharePowerInfo sharePowerInfo; + + /** + * 充电宝投诉相关信息 + */ + @Data + public static class SharePowerInfo implements Serializable { + private static final long serialVersionUID = -2878382307459369354L; + + /** + *
+ * 字段名:归还时间 + * 是否必填:否 + * 描述:遵循rfc3339标准格式,格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE, + * yyyy-MM-DD表示年月日,T出现在字符串中,表示time元素的开头, + * HH:mm:ss表示时分秒, + * TIMEZONE表示时区(+08:00表示东八区时间,领先UTC 8小时,即北京时间)。 + * 示例值:2015-05-20T13:29:35+08:00表示,北京时间2015年5月20日 13点29分35秒 + *+ */ + @SerializedName("return_time") + private String returnTime; + + /** + *
+ * 字段名:归还地点信息 + * 是否必填:否 + * 描述: 归还地点信息 + *+ */ + @SerializedName("return_address_info") + private ReturnAddressInfo returnAddressInfo; + + @Data + public static class ReturnAddressInfo implements Serializable { + private static final long serialVersionUID = -7649986542568217256L; + + /** + *
+ * 字段名:归还地点 + * 是否必填:否 string(256) + * 描述:归还地点 + *+ */ + @SerializedName("return_address") + private String returnAddress; + + /** + *
+ * 字段名:归还地点经度 + * 是否必填:否 string(32) + * 描述:经度,字符串,范围为-180~180,负数表示西经。使用GCJ-02坐标系 + *+ */ + @SerializedName("longitude") + private String longitude; + + /** + *
+ * 字段名:归还地点纬度 + * 是否必填:否 string(32) + * 描述:纬度,字符串,范围为-90~90,负数表示南纬。使用GCJ-02坐标系 + *+ */ + @SerializedName("latitude") + private String latitude; + } + + /** + *
+ * 字段名:是否归还同一柜机 + * 是否必填:否 + * 描述:用户声明是否将充电宝归还至与借取时同一柜机 + *+ */ + @SerializedName("is_returned_to_same_machine") + private Boolean isReturnedToSameMachine; + } + } + + /** + *
+ * 字段名:是否在平台协助中 + * 是否必填:否 + * 描述:标识当前投诉单是否正处在平台协助流程中。 + * 注:在协助期间由微信支付客服为用户服务,期间商户向用户发送的留言用户不可见 + *+ */ + @SerializedName("in_platform_service") + private Boolean inPlatformService; + + /** + *
+ * 字段名:是否需即时服务用户 + * 是否必填:否 + * 描述:因用户诉求紧急度、用户界面差异等因素,部分投诉单建议商户更即时地响应用户诉求。 + * 如此处标识为“是”,建议商户提升服务时效,给用户带来更好的体验 + *+ */ + @SerializedName("need_immediate_service") + private Boolean needImmediateService; + + } diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/NegotiationHistoryResult.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/NegotiationHistoryResult.java index 2da216446..7c8738fe2 100644 --- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/NegotiationHistoryResult.java +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/NegotiationHistoryResult.java @@ -142,20 +142,30 @@ public class NegotiationHistoryResult implements Serializable { * 是否必填:是 * 描述: * 当前投诉协商记录的操作类型,对应枚举: - * USER_CREATE_COMPLAINT:用户提交投诉 - * USER_CONTINUE_COMPLAINT:用户继续投诉 - * USER_RESPONSE:用户留言 - * PLATFORM_RESPONSE:平台留言 - * MERCHANT_RESPONSE:商户留言 - * MERCHANT_CONFIRM_COMPLETE:商户申请结单 - * COMPLAINT_FULL_REFUNDED:投诉单全额退款 - * USER_CREATE_COMPLAINT_SYSTEM_MESSAGE:用户提交投诉系统通知 - * COMPLAINT_FULL_REFUNDED_SYSTEM_MESSAGE:投诉单全额退款系统通知 - * USER_CONTINUE_COMPLAINT_SYSTEM_MESSAGE:用户继续投诉系统通知 - * MERCHANT_CONFIRM_COMPLETE_SYSTEM_MESSAGE:商户申请结单系统通知 - * USER_REVOKE_COMPLAINT:用户主动撤诉(只存在于历史投诉单的协商历史中) - * PLATFORM_HELP_APPLICATION:平台问询 - * USER_APPLY_PLATFORM_HELP:申请协助 + * USER_CREATE_COMPLAINT: 用户提交投诉 + * USER_CONTINUE_COMPLAINT: 用户继续投诉 + * USER_RESPONSE: 用户留言 + * PLATFORM_RESPONSE: 平台留言 + * MERCHANT_RESPONSE: 商户留言 + * MERCHANT_CONFIRM_COMPLETE: 商户申请结单 + * USER_CREATE_COMPLAINT_SYSTEM_MESSAGE: 用户提交投诉系统通知 + * COMPLAINT_FULL_REFUNDED_SYSTEM_MESSAGE: 投诉单发起全额退款系统通知 + * USER_CONTINUE_COMPLAINT_SYSTEM_MESSAGE: 用户继续投诉系统通知 + * USER_REVOKE_COMPLAINT: 用户主动撤诉(只存在于历史投诉单的协商历史中) + * USER_COMFIRM_COMPLAINT: 用户确认投诉解决(只存在于历史投诉单的协商历史中) + * PLATFORM_HELP_APPLICATION: 平台催办 + * USER_APPLY_PLATFORM_HELP: 用户申请平台协助 + * MERCHANT_APPROVE_REFUND: 商户同意退款申请 + * MERCHANT_REFUSE_RERUND: 商户拒绝退款申请, 此时操作内容里展示拒绝原因 + * USER_SUBMIT_SATISFACTION: 用户提交满意度调查结果,此时操作内容里会展示满意度分数 + * SERVICE_ORDER_CANCEL: 服务订单已取消 + * SERVICE_ORDER_COMPLETE: 服务订单已完成 + * COMPLAINT_PARTIAL_REFUNDED_SYSTEM_MESSAGE: 投诉单发起部分退款系统通知 + * COMPLAINT_REFUND_RECEIVED_SYSTEM_MESSAGE: 投诉单退款到账系统通知 + * COMPLAINT_ENTRUSTED_REFUND_SYSTEM_MESSAGE: 投诉单受托退款系统通知 + * USER_APPLY_PLATFORM_SERVICE: 用户申请平台协助 + * USER_CANCEL_PLATFORM_SERVICE: 用户取消平台协助 + * PLATFORM_SERVICE_FINISHED: 客服结束平台协助 * */ @SerializedName("operate_type") @@ -179,11 +189,32 @@ public class NegotiationHistoryResult implements Serializable { * 描述: * 当前投诉协商记录提交的图片凭证(url格式),最多返回4张图片,url有效时间为1小时。如未查询到协商历史图片凭证,则返回空数组。 * 注:本字段包含商户、微信支付客服在协商解决投诉时上传的图片凭证,若希望查看用户图片,请使用complaint_media_list字段并联系微信支付客服 + * 注:此字段不包含用户提交的图片凭证,建议统一使用complaint_media_list字段接收和请求资料凭证,未来该字段将废弃 * */ @SerializedName("image_list") private List
+ * 字段名:用户申请平台协助原因 + * 是否必填:否 + * 描述:用户此次申请平台协助时选择的申请协助原因 + *+ */ + @SerializedName("user_appy_platform_service_reason") + private String userApplyPlatformServiceReason; + + /** + *
+ * 字段名:用户申请平台协助原因描述 + * 是否必填:否 + * 描述:用户此次申请平台协助时填写的具体申请协助原因描述 + *+ */ + @SerializedName("user_appy_platform_service_reason_description") + private String userApplyPlatformServiceReasonDescription; + } } diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/ResponseRequest.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/ResponseRequest.java index 6f582b930..470f2bed1 100644 --- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/ResponseRequest.java +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/ResponseRequest.java @@ -94,4 +94,57 @@ public class ResponseRequest implements Serializable { @SerializedName("jump_url_text") private String jumpUrlText; + /** + *
+ * 字段名:跳转小程序信息 + * 是否必填:否 + * 描述:商户可在回复中附加小程序信息,引导用户跳转至商户客诉处理小程序。 + * 注:配置小程序属于灰度功能,若有需要请联系对接的行业运营进行咨询。 + *+ */ + @SerializedName("mini_program_jump_info") + private MiniProgramJumpInfo miniProgramJumpInfo; + + + /** + * 跳转小程序信息 + */ + @Data + public static class MiniProgramJumpInfo implements Serializable { + private static final long serialVersionUID = 1169503275787468380L; + + /** + *
+ * 字段名:跳转小程序APPID + * 是否必填:是 + * 描述:商户可在回复中附加小程序页面路径,引导用户跳转至商户服务工具页面。 + * 该字段为小程序APPID。 + *+ */ + @SerializedName("appid") + private String appId; + + /** + *
+ * 字段名:跳转小程序页面PATH + * 是否必填:是 + * 描述:商户可在回复中附加小程序页面路径,引导用户跳转至商户服务工具页面。 + * 该字段为小程序路径。 + *+ */ + @SerializedName("path") + private String path; + + /** + *
+ * 字段名:跳转小程序页面名称 + * 是否必填:是 + * 描述:商户可在回复中附加小程序页面路径,引导用户跳转至商户服务工具页面。 + * 该字段为商户可自定义的页面名称。 + *+ */ + @SerializedName("text") + private String text; + } + } diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/UpdateRefundProgressRequest.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/UpdateRefundProgressRequest.java index f7715c522..79668bd0c 100644 --- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/UpdateRefundProgressRequest.java +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/UpdateRefundProgressRequest.java @@ -61,7 +61,7 @@ public class UpdateRefundProgressRequest implements Serializable { /** *
* 字段名:拒绝退款原因 - * 是否必填:否 + * 是否必填:否 string(200) * 描述:在拒绝退款时返回拒绝退款的原因 **/ @@ -72,7 +72,9 @@ public class UpdateRefundProgressRequest implements Serializable { *
* 字段名:拒绝退款的举证图片列表 * 是否必填:否 - * 描述:在拒绝退款时,如果有拒绝的图片举证,可以提供 最多上传4张图片, 传入调用“商户上传反馈图片”接口返回的media_id,最多上传4张图片凭证 + * 描述:在拒绝退款时,如果有拒绝的图片举证,可以提供 最多上传4张图片, + * 传入调用“商户上传反馈图片”接口返回的media_id,最多上传4张图片凭证 + * **/ @SerializedName("reject_media_list") @@ -81,7 +83,7 @@ public class UpdateRefundProgressRequest implements Serializable { /** *
* 字段名:备注 - * 是否必填:否 + * 是否必填:否 string(200) * 描述:任何需要向微信支付客服反馈的信息 **/ diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/ComplaintNotifyResult.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/ComplaintNotifyResult.java index a5d18df6d..9464144c1 100644 --- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/ComplaintNotifyResult.java +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/ComplaintNotifyResult.java @@ -47,13 +47,23 @@ public class ComplaintNotifyResult implements Serializable { * 是否必填:是 * 描述: * 触发本次投诉通知回调的具体动作类型,枚举如下: + * 常规通知: * CREATE_COMPLAINT:用户提交投诉 * CONTINUE_COMPLAINT:用户继续投诉 * USER_RESPONSE:用户新留言 * RESPONSE_BY_PLATFORM:平台新留言 - * SELLER_REFUND:收款方全额退款 + * SELLER_REFUND:商户发起全额退款 * MERCHANT_RESPONSE:商户新回复 * MERCHANT_CONFIRM_COMPLETE:商户反馈处理完成 + * USER_APPLY_PLATFORM_SERVICE:用户申请平台协助 + * USER_CANCEL_PLATFORM_SERVICE:用户取消平台协助 + * PLATFORM_SERVICE_FINISHED:客服结束平台协助 + * + * 申请退款单的附加通知: + * 以下通知会更新投诉单状态,建议收到后查询投诉单详情。 + * MERCHANT_APPROVE_REFUND:商户同意退款 + * MERCHANT_REJECT_REFUND:商户驳回退款 + * REFUND_SUCCESS:退款到账 * */ @SerializedName(value = "action_type") diff --git a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/ComplaintService.java b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/ComplaintService.java index 66de1458a..6fc1367cf 100644 --- a/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/ComplaintService.java +++ b/weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/ComplaintService.java @@ -152,7 +152,7 @@ public interface ComplaintService { /** *
* 商户上传反馈图片API - * 文档详见: ... + * 文档详见: ... * 接口链接:https://api.mch.weixin.qq.com/v3/merchant-service/images/upload ** @@ -165,7 +165,7 @@ public interface ComplaintService { /** *
* 商户上传反馈图片API - * 文档详见: ... + * 文档详见: ... * 接口链接:https://api.mch.weixin.qq.com/v3/merchant-service/images/upload **