🎨 #3490【微信支付】消费者投诉相关接口补充最新增加的一些参数

Author: je45

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/ComplaintDetailResult.java

@@ -327,4 +327,141 @@ public static class ServiceOrder implements Serializable {
  */
  @SerializedName("user_tag_list")
  private String[] userTagList;
+
+ /**
+ * <pre>
+ * 字段名：补充信息
+ * 是否必填：否
+ * 描述： 用在特定行业或场景下返回的补充信息
+ * </pre>
+ */
+ @SerializedName("additional_info")
+ private AdditionalInfo additionalInfo;
+
+ @Data
+ public static class AdditionalInfo implements Serializable {
+ private static final long serialVersionUID = 7917816070738944147L;
+
+ /**
+ * <pre>
+ * 字段名：补充信息类型
+ * 是否必填：否
+ * 描述： 补充信息类型
+ * 示例值：SHARE_POWER_TYPE: 充电宝投诉相关行业
+ * </pre>
+ */
+ @SerializedName("type")
+ private String type;
+
+ /**
+ * <pre>
+ * 字段名：充电宝投诉相关信息
+ * 是否必填：否
+ * 描述：当type为充电宝投诉相关时有值
+ * </pre>
+ */
+ @SerializedName("share_power_info")
+ private SharePowerInfo sharePowerInfo;
+
+ /**
+ * 充电宝投诉相关信息
+ */
+ @Data
+ public static class SharePowerInfo implements Serializable {
+ private static final long serialVersionUID = -2878382307459369354L;
+
+ /**
+ * <pre>
+ * 字段名：归还时间
+ * 是否必填：否
+ * 描述：遵循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秒
+ * </pre>
+ */
+ @SerializedName("return_time")
+ private String returnTime;
+
+ /**
+ * <pre>
+ * 字段名：归还地点信息
+ * 是否必填：否
+ * 描述： 归还地点信息
+ * </pre>
+ */
+ @SerializedName("return_address_info")
+ private ReturnAddressInfo returnAddressInfo;
+
+ @Data
+ public static class ReturnAddressInfo implements Serializable {
+ private static final long serialVersionUID = -7649986542568217256L;
+
+ /**
+ * <pre>
+ * 字段名：归还地点
+ * 是否必填：否 string(256)
+ * 描述：归还地点
+ * </pre>
+ */
+ @SerializedName("return_address")
+ private String returnAddress;
+
+ /**
+ * <pre>
+ * 字段名：归还地点经度
+ * 是否必填：否 string(32)
+ * 描述：经度，字符串，范围为-180~180，负数表示西经。使用GCJ-02坐标系
+ * </pre>
+ */
+ @SerializedName("longitude")
+ private String longitude;
+
+ /**
+ * <pre>
+ * 字段名：归还地点纬度
+ * 是否必填：否 string(32)
+ * 描述：纬度，字符串，范围为-90~90，负数表示南纬。使用GCJ-02坐标系
+ * </pre>
+ */
+ @SerializedName("latitude")
+ private String latitude;
+ }
+
+ /**
+ * <pre>
+ * 字段名：是否归还同一柜机
+ * 是否必填：否
+ * 描述：用户声明是否将充电宝归还至与借取时同一柜机
+ * </pre>
+ */
+ @SerializedName("is_returned_to_same_machine")
+ private Boolean isReturnedToSameMachine;
+ }
+ }
+
+ /**
+ * <pre>
+ * 字段名：是否在平台协助中
+ * 是否必填：否
+ * 描述：标识当前投诉单是否正处在平台协助流程中。
+ * 注：在协助期间由微信支付客服为用户服务，期间商户向用户发送的留言用户不可见
+ * </pre>
+ */
+ @SerializedName("in_platform_service")
+ private Boolean inPlatformService;
+
+ /**
+ * <pre>
+ * 字段名：是否需即时服务用户
+ * 是否必填：否
+ * 描述：因用户诉求紧急度、用户界面差异等因素，部分投诉单建议商户更即时地响应用户诉求。
+ * 如此处标识为“是”，建议商户提升服务时效，给用户带来更好的体验
+ * </pre>
+ */
+ @SerializedName("need_immediate_service")
+ private Boolean needImmediateService;
+
+
 }

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/NegotiationHistoryResult.java

@@ -142,20 +142,30 @@ public static class ComplaintMedia 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: 客服结束平台协助
  * </pre>
  */
  @SerializedName("operate_type")
@@ -179,11 +189,32 @@ public static class ComplaintMedia implements Serializable {
  * 描述：
  * 当前投诉协商记录提交的图片凭证（url格式），最多返回4张图片，url有效时间为1小时。如未查询到协商历史图片凭证，则返回空数组。
  * 注：本字段包含商户、微信支付客服在协商解决投诉时上传的图片凭证，若希望查看用户图片，请使用complaint_media_list字段并联系微信支付客服
+ * 注：此字段不包含用户提交的图片凭证，建议统一使用complaint_media_list字段接收和请求资料凭证，未来该字段将废弃
  * </pre>
  */
  @SerializedName("image_list")
  private List<String> imageList;
 
+ /**
+ * <pre>
+ * 字段名：用户申请平台协助原因
+ * 是否必填：否
+ * 描述：用户此次申请平台协助时选择的申请协助原因
+ * </pre>
+ */
+ @SerializedName("user_appy_platform_service_reason")
+ private String userApplyPlatformServiceReason;
+
+ /**
+ * <pre>
+ * 字段名：用户申请平台协助原因描述
+ * 是否必填：否
+ * 描述：用户此次申请平台协助时填写的具体申请协助原因描述
+ * </pre>
+ */
+ @SerializedName("user_appy_platform_service_reason_description")
+ private String userApplyPlatformServiceReasonDescription;
+
  }
 
 }

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;
 
+ /**
+ * <pre>
+ * 字段名：跳转小程序信息
+ * 是否必填：否
+ * 描述：商户可在回复中附加小程序信息，引导用户跳转至商户客诉处理小程序。
+ * 注：配置小程序属于灰度功能，若有需要请联系对接的行业运营进行咨询。
+ * </pre>
+ */
+ @SerializedName("mini_program_jump_info")
+ private MiniProgramJumpInfo miniProgramJumpInfo;
+
+
+ /**
+ * 跳转小程序信息
+ */
+ @Data
+ public static class MiniProgramJumpInfo implements Serializable {
+ private static final long serialVersionUID = 1169503275787468380L;
+
+ /**
+ * <pre>
+ * 字段名：跳转小程序APPID
+ * 是否必填：是
+ * 描述：商户可在回复中附加小程序页面路径，引导用户跳转至商户服务工具页面。
+ * 该字段为小程序APPID。
+ * </pre>
+ */
+ @SerializedName("appid")
+ private String appId;
+
+ /**
+ * <pre>
+ * 字段名：跳转小程序页面PATH
+ * 是否必填：是
+ * 描述：商户可在回复中附加小程序页面路径，引导用户跳转至商户服务工具页面。
+ * 该字段为小程序路径。
+ * </pre>
+ */
+ @SerializedName("path")
+ private String path;
+
+ /**
+ * <pre>
+ * 字段名：跳转小程序页面名称
+ * 是否必填：是
+ * 描述：商户可在回复中附加小程序页面路径，引导用户跳转至商户服务工具页面。
+ * 该字段为商户可自定义的页面名称。
+ * </pre>
+ */
+ @SerializedName("text")
+ private String text;
+ }
+
 }

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/complaint/UpdateRefundProgressRequest.java

@@ -61,7 +61,7 @@ public class UpdateRefundProgressRequest implements Serializable {
  /**
  * <pre>
  * 字段名：拒绝退款原因
- * 是否必填：否
+ * 是否必填：否 string(200)
  * 描述：在拒绝退款时返回拒绝退款的原因
  * </pre>
  */
@@ -72,7 +72,9 @@ public class UpdateRefundProgressRequest implements Serializable {
  * <pre>
  * 字段名：拒绝退款的举证图片列表
  * 是否必填：否
- * 描述：在拒绝退款时，如果有拒绝的图片举证，可以提供 最多上传4张图片, 传入调用“商户上传反馈图片”接口返回的media_id，最多上传4张图片凭证
+ * 描述：在拒绝退款时，如果有拒绝的图片举证，可以提供 最多上传4张图片,
+ * 传入调用“商户上传反馈图片”接口返回的media_id，最多上传4张图片凭证
+ *
  * </pre>
  */
  @SerializedName("reject_media_list")
@@ -81,7 +83,7 @@ public class UpdateRefundProgressRequest implements Serializable {
  /**
  * <pre>
  * 字段名：备注
- * 是否必填：否
+ * 是否必填：否 string(200)
  * 描述：任何需要向微信支付客服反馈的信息
  * </pre>
  */

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/bean/notify/ComplaintNotifyResult.java

@@ -47,13 +47,23 @@ public static class DecryptNotifyResult 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：退款到账
  * </pre>
  */
  @SerializedName(value = "action_type")

weixin-java-pay/src/main/java/com/github/binarywang/wxpay/service/ComplaintService.java

@@ -152,7 +152,7 @@ public interface ComplaintService {
  /**
  * <pre>
  * 商户上传反馈图片API
- * 文档详见: <a href="https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter10_2_10.shtml">...</a>
+ * 文档详见: <a href="https://pay.weixin.qq.com/docs/merchant/apis/consumer-complaint/images/create-images.html">...</a>
  * 接口链接：https://api.mch.weixin.qq.com/v3/merchant-service/images/upload
  * </pre>
  *
@@ -165,7 +165,7 @@ public interface ComplaintService {
  /**
  * <pre>
  * 商户上传反馈图片API
- * 文档详见: <a href="https://pay.weixin.qq.com/wiki/doc/apiv3/apis/chapter10_2_10.shtml">...</a>
+ * 文档详见: <a href="https://pay.weixin.qq.com/docs/merchant/apis/consumer-complaint/images/create-images.html">...</a>
  * 接口链接：https://api.mch.weixin.qq.com/v3/merchant-service/images/upload
  * </pre>
  *