投诉单列表查询

POST/v1/violation/complaintListQuery

请求参数

mch_id

string

商户编号

必需

商户编号是商户在连连支付支付平台上开设的商户号码，为18位数字，如：201304121000001004。测试阶段可以先用测试商户号测试。

<= 18 字符

sub_mch_id

string

子商户号

可选

子商户号。微信渠道，指对应的微信子商户号，二级商户收单场景必传

<= 字符

chnl_type

string

渠道类型

必需

渠道类型。WECHAT: 微信，ALIPAY: 支付宝

<= 字符

query_date

string

查询日期

可选

只能按日查询。正则匹配:yyyy-MM-dd。query_date与[start_date&end_date]传其一，如都传优先取query_date

<= 10 字符

start_date

string

查询开始日期

可选

与end_date同时存在，优先取query_date

正则匹配:

yyyy-MM-dd

end_date

string

查询结束日期

可选

与start_date同时存在，时间范围为30天

正则匹配:

yyyy-MM-dd

complaint_id

string

投诉单号

可选

新加查询条件

<= 64 字符

complaint_state

enum<string>

投诉单状态

可选

新加查询条件

枚举值:

PENDINGPROCESSINGPROCESSEDDROP_COMPLAIN

txn_seqno

string

商户订单号

可选

新加查询条件

<= 64 字符

platform_txno

string

平台订单号

可选

新加查询条件

<= 32 字符

page

integer

页码

可选

新加分页参数

>= 1

默认值:

limit

integer

页大小

可选

新加分页参数

>= 1<= 50

默认值:

{
  "mch_id": "string",
  "sub_mch_id": "string",
  "chnl_type": "string",
  "query_date": "string",
  "start_date": "string",
  "end_date": "string",
  "complaint_id": "string",
  "complaint_state": "PENDING",
  "txn_seqno": "string",
  "platform_txno": "string",
  "page": 1,
  "limit": 30
}

示例代码

返回响应

成功(200)

HTTP 状态码: 200

内容格式: JSONapplication/json

ret_code

string

请求结果代码

可选

请求结果代码。详见请求结果代码说明。

<= 4 字符

ret_msg

string

请求结果描述

可选

请求结果描述

<= 100 字符

mch_id

string

商户编号是商户在连连支付支付平台上开设的商户号码，为18位数字，如：201304121000001004

可选

商户编号是商户在连连支付支付平台上开设的商户号码，为18位数字，如：201304121000001004。

<= 18 字符

total

integer

投诉单总数

必需

新加字段

complaint_list

array[object (投诉单列表) {18}]

投诉单列表

必需

投诉单列表

complaint_id

string

投诉单号

必需

投诉单号

<= 64 字符

complaint_time

string

投诉时间

必需

投诉时间。正则匹配:yyyy-MM-dd HH:mm:ss

<= 64 字符

complaint_state

string

投诉状态

必需

投诉状态。枚举值:PENDING :待处理PROCESSING :处理中PROCESSED :已处理完成 DROP_COMPLAIN: 用户撤诉

<= 字符

complaint_detail

string

投诉详情

必需

投诉详情

sub_mch_id

string

投诉子商户号

必需

投诉子商户号。

<= 字符

payer_phone

string

投诉人手机号

可选

投诉人手机号。

<= 字符

wechat_complaint_full_refunded

boolean

投诉单是否已全额退款

可选

微信渠道返回

wechat_incoming_user_response

boolean

是否有待回复的用户留言

可选

微信渠道返回

wechat_user_complaint_times

integer

用户投诉次数

可选

微信渠道返回

wechat_problem_description

string

问题描述

可选

微信渠道返回

<= 字符

wechat_problem_type

string

问题类型

可选

微信渠道返回。枚举值:REFUND :申请退款SERVICE_NOT_WORK :服务权益未生效OTHERS :其他类型

<= 字符

wechat_apply_refund_amount

integer

申请退款金额

可选

微信渠道返回

wechat_user_tag_list

array[string]

用户标签列表

可选

微信渠道返回。枚举值:TRUSTED：此类用户满足极速退款条件HIGH_RISK：高风险投诉，请按照运营要求优先妥善处理

complaint_order_info

array[object (投诉单关联订单信息) {9}]

投诉单关联订单信息

必需

投诉单关联订单信息

complaint_media_list

array[object (投诉资料列表) {2}]

投诉资料列表

可选

投诉资料列表

wechat_service_order_info

array[object (投诉单关联服务单信息) {3}]

投诉单关联服务单信息

可选

微信渠道返回

wechat_additional_info

object (补充信息)

补充信息

可选

微信渠道返回

complaint_type

enum<string>

投诉单类型

必需

枚举值:

MERCHANT

未设置