iPos接口接入报文规范 - 微信投诉单详情查询 - 《iPos-SA支付版》

业务说明
请求报文
请求报文说明
返回报文
返回报文说明
- detail 详情 (JSONObject)

业务说明

商户可通过调用此接口，查询指定投诉单的用户投诉详情，包含投诉关联订单信息、支付分服务单信息、投诉的问题类型、问题描述、投诉人联系方式等信息，方便商户处理投诉。

请求报文

JSON:

{
    "request_type": "risk_complaints_detail_request",
    "isspid": "39493002",
    "transaction_id": "query202406170000000001",
    "system_id": "8888",
    "seller_account": "66660000000000001",
    "complaint_id": "200201820200101080076610000",
    "sign": "2EB4051F33C84719D59E0F5EADACF5D2"
}

XML:

<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <request_type>risk_complaints_detail_request</request_type>
    <isspid>39493002</isspid>
    <transaction_id>query202406170000000001</transaction_id>
    <system_id>8888</system_id>
    <seller_account>66660000000000001</seller_account>
    <complaint_id>200201820200101080076610000</complaint_id>
</business_trans>

请求报文说明

节点名称	中文名称	类型	说明	是否必填
sign	报文签名	String(32)	请求报文格式为JSON时必填计算签名方式请看2.1章节	可空
request_type	请求类型	String(32)	固定值：risk_complaints_listquery_request	必填
isspid	商户号	String(8)	翼码商户号，由翼码提供	必填
transaction_id	请求流水号	String(32)		必填
system_id	系统平台号	String(4)	由翼码提供	必填
seller_account	收款账户编号	String(64)		必填
complaint_id	投诉单号	String(64)		必填

返回报文

JSON:

{
    "response_type": "risk_complaints_detail_response",
    "isspid": "39493002",
    "transaction_id": "query2022083111260000001",
    "seller_account": "66660000000000001",
    "complaint_id": "200201820200101080076610000",
    "detail": {
        "complaint_detail": "反馈一个重复扣费的问题",
        "complaint_full_refunded": true,
        "complaint_id": "200201820200101080076610000",
        "complaint_media_list": [
            {
                "media_type": "USER_COMPLAINT_IMAGE",
                "media_url": [
                    "https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
                ]
            }
        ],
        "complaint_order_info": [
            {
                "amount": "3",
                "out_trade_no": "20190906154617947762231",
                "transaction_id": "4200000404201909069117582536"
            }
        ],
        "complaint_state": "PENDING",
        "complaint_time": "2015-05-20T13:29:35.120+08:00",
        "complainted_mchid": "1900012181",
        "incoming_user_response": true,
        "payer_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
        "payer_phone": "18500000000",
        "problem_description": "不满意商家服务",
        "problem_type": "REFUND",
        "apply_refund_amount": 10,
        "service_order_info": [
            {
                "order_id": "15646546545165651651",
                "out_order_no": "1234323JKHDFE1243252",
                "state": "DOING"
            }
        ],
        "user_complaint_times": 1,
        "user_tag_list": [
            "TRUSTED"
        ]
    },
    "result": {
        "id": "0000",
        "comment": "查询成功"
    },
    "sign": "824FE953936278AEE61CA8CEE8A08C86"
}

XML:

<?xml version="1.0" encoding="GBK"?>
<business_trans>
    <response_type>risk_complaints_detail_response</response_type>
    <isspid>39493002</isspid>
    <transaction_id>query2022083111260000001</transaction_id>
    <seller_account>66660000000000001</seller_account>
    <complaint_id>200201820200101080076610000</complaint_id>
    <detail><![CDATA[
    {
        "complaint_detail": "反馈一个重复扣费的问题",
        "complaint_full_refunded": true,
        "complaint_id": "200201820200101080076610000",
        "complaint_media_list": [
            {
                "media_type": "USER_COMPLAINT_IMAGE",
                "media_url": [
                    "https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
                ]
            }
        ],
        "complaint_order_info": [
            {
                "amount": "3",
                "out_trade_no": "20190906154617947762231",
                "transaction_id": "4200000404201909069117582536"
            }
        ],
        "complaint_state": "PENDING",
        "complaint_time": "2015-05-20T13:29:35.120+08:00",
        "complainted_mchid": "1900012181",
        "incoming_user_response": true,
        "payer_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
        "payer_phone": "18500000000",
        "problem_description": "不满意商家服务",
        "problem_type": "REFUND",
        "apply_refund_amount": 10,
        "service_order_info": [
            {
                "order_id": "15646546545165651651",
                "out_order_no": "1234323JKHDFE1243252",
                "state": "DOING"
            }
        ],
        "user_complaint_times": 1,
        "user_tag_list": [
            "TRUSTED"
        ]
    }
    ]]></detail>
    <result>
        <id>0000</id>
        <comment>查询成功</comment>
    </result>
</business_trans>

返回报文说明

标准接口会因业务升级需要而新增节点，请在解析返回报文时避免新增未知节点产生的程序出错！

节点名称	中文名称	类型	说明	是否必填
sign	报文签名	String(32)	返回报文格式为JSON时必填计算签名方式请看2.1章节	可选
response_type	返回类型	String(32)	固定值：risk_complaints_detail_response	必填
isspid	商户号	String(8)	翼码商户号，由翼码提供	必填
transaction_id	请求流水号	String(32)	与请求报文相同	必填
seller_account	收款账户编号	String(64)	与请求报文相同	必填
complaint_id	投诉单号	String(64)	与请求报文相同	必填
detail	详情	JSONObject	详情采用JSON格式 XML报文时使用CDATA标签包裹	可空
result ->id	响应码	String(4)	0000：查询成功其它失败，错误信息说明见“响应码解释”字段	必填
result ->comment	响应码解释	String(64)	响应码对应中文注解，用于显示提示	必填

标准接口会因业务升级需要而新增节点，请在解析返回报文时避免新增未知节点产生的程序出错！

detail 详情 (JSONObject)

JSON节点	参数名称	类型	说明	是否必填
complaint_detail	投诉详情	String(300)	投诉的具体描述	必填
complaint_full_refunded	投诉单是否已全额退款	boolean	true：已全额退款 false：未全额退款	必填
complaint_id	投诉单号	String(64)		必填
complaint_media_list	投诉资料列表	JSONArray	用户上传的投诉相关资料，包括图片凭证等	可空
complaint_order_info	投诉单关联订单信息	JSONArray		必填
complaint_state	投诉单状态	String(30)	标识当前投诉单所处的处理阶段，具体状态如下所示： PENDING：待处理 PROCESSING：处理中 PROCESSED：已处理完成	必填
complaint_time	投诉时间	String(32)	yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE	必填
complainted_mchid	被诉商户号	String(64)		必填
incoming_user_response	是否有待回复的用户留言	boolean	true：是 false：否	必填
payer_openid	投诉人OpenID	String(128)	投诉人在商户AppID下的唯一标识，支付分服务单类型无	可空
payer_phone	投诉人联系方式	String(64)		可空
problem_description	问题描述	String(256)	用户发起投诉前选择的faq标题（2021年7月15日之后的投诉单均包含此信息）	必填
problem_type	问题类型	String	可选取值 REFUND：申请退款 SERVICE_NOT_WORK：服务权益未生效 OTHERS：其他类型	可空
apply_refund_amount	申请退款金额	Integer	仅当问题类型为申请退款时有值，单位：分	可空
service_order_info	投诉单关联服务单信息	JSONArray		可空
user_complaint_times	用户投诉次数	Integer	用户首次发起投诉记为1次，用户每有一次继续投诉就加1	必填
user_tag_list	用户标签列表	Array[String]	可选取值 TRUSTED：此类用户满足极速退款条件 HIGH_RISK：高风险投诉，请按照运营要求优先妥善处理	可空

complaint_media_list 投诉资料列表 (JSONArray)

JSON节点	参数名称	类型	说明	是否必填
media_type	媒体文件业务类型	String	USER_COMPLAINT_IMAGE：用户提交投诉时上传的图片凭证 OPERATION_IMAGE：用户、商户、微信支付客服在协商解决投诉时，上传的图片凭证	必填
media_url	媒体文件请求url	Array[String(512)]	微信返回的媒体文件请求url	必填

complaint_order_info 投诉单关联订单信息 (JSONArray)

JSON节点	参数名称	类型	说明	是否必填
amount	订单金额	String(9)	单位分	必填
out_trade_no	商户订单号	String(64)		必填
transaction_id	微信订单号	String(64)		必填

service_order_info 投诉单关联服务单信息 (JSONArray)

JSON节点	参数名称	类型	说明	是否必填
order_id	微信支付服务订单号	String(128)	微信支付服务订单号，每个微信支付服务订单号与商户号下对应的商户服务订单号一一对应	可空
out_order_no	商户服务订单号	String(128)	商户系统内部服务订单号（不是交易单号），与创建订单时一致	可空
state	支付分服务单状态	String	DOING：服务订单进行中 REVOKED：服务订单已取消 WAITPAY：服务订单待支付 DONE：服务订单已完成	可空

4.71.微信投诉单详情查询

业务说明

请求报文

请求报文说明

返回报文

返回报文说明

detail 详情 (JSONObject)

complaint_media_list 投诉资料列表 (JSONArray)

complaint_order_info 投诉单关联订单信息 (JSONArray)

service_order_info 投诉单关联服务单信息 (JSONArray)