最新更新時間:2023.03.07 版本說明
商戶可通過調用此接口,查詢指定投訴單的用戶投訴詳情,包含投訴關聯(lián)訂單信息/支付分服務單信息、投訴的問題類型、問題描述、投訴人聯(lián)系方式等信息,方便商戶處理投訴。
適用對象:直連商戶
請求URL:https://api.mch.weixin.qq.com/v3/merchant-service/complaints-v2/{complaint_id}
請求方式:GET
path 指該參數為路徑參數
query 指該參數為URL參數
body 指該參數需在請求JSON傳參
參數名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
投訴單號 | complaint_id | string[1,64] | 是 | path投訴單對應的投訴單號 示例值:200201820200101080076610000 |
https://api.mch.weixin.qq.com/v3/merchant-service/complaints-v2/200201820200101080076610000
參數名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
投訴單號 | complaint_id | string[1, 64] | 是 | 投訴單對應的投訴單號 示例值:200201820200101080076610000 |
投訴時間 | complaint_time | string[1, 32] | 是 | 投訴時間,遵循rfc3339標準格式,格式為yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE,yyyy-MM-DD表示年月日,T出現(xiàn)在字符串中,表示time元素的開頭,HH:mm:ss.sss表示時分秒毫秒,TIMEZONE表示時區(qū)(+08:00表示東八區(qū)時間,領先UTC 8小時,即北京時間)。例如:2015-05-20T13:29:35.120+08:00表示北京時間2015年05月20日13點29分35秒 示例值:2015-05-20T13:29:35.120+08:00 |
投訴詳情 | complaint_detail | string[1, 300] | 是 | 投訴的具體描述 示例值:反饋一個重復扣費的問題 |
被訴商戶號 | complainted_mchid | string[1, 64] | 否 | 投訴單對應的被訴商戶號。 示例值:1900012181 |
投訴單狀態(tài) | complaint_state | string[1, 30] | 是 | 標識當前投訴單所處的處理階段,具體狀態(tài)如下所示: PENDING:待處理 PROCESSING:處理中 PROCESSED:已處理完成 示例值:PENDING |
投訴人聯(lián)系方式 | payer_phone | string[1, 256] | 否 | 投訴人聯(lián)系方式。該字段已做加密處理,具體解密方法詳見敏感信息加密說明。 示例值:sGdNeTHMQGlxCWiUyHu6XNO9GCYln2Luv4HhwJzZBfcL12sB |
投訴人openid | payer_openid | string[1, 128] | 是 | 投訴人在商戶appid下的唯一標識 示例值:oUpF8uMuAJO_M2pxb1Q9zNjWeS6o |
+投訴資料列表 | complaint_media_list | array | 是 | 用戶上傳的投訴相關資料,包括圖片憑證等 |
+投訴單關聯(lián)訂單信息 | complaint_order_info | array | 是 | 投訴單關聯(lián)訂單信息 注:投訴單和訂單目前是一對一關系,array是預留未來一對多的擴展 |
+投訴單關聯(lián)服務單信息 | service_order_info | array | 否 | 投訴單關聯(lián)服務單信息, 支付分服務單投訴時可能存在 |
投訴單是否已全額退款 | complaint_full_refunded | boolean | 是 | 投訴單下所有訂單是否已全部全額退款 示例值:true |
是否有待回復的用戶留言 | incoming_user_response | boolean | 是 | 投訴單是否有待回復的用戶留言 示例值:true |
問題描述 | problem_description | string[1, 256] | 是 | 用戶發(fā)起投訴前選擇的faq標題(2021年7月15日之后的投訴單均包含此信息) 示例值:不滿意商家服務 |
用戶投訴次數 | user_complaint_times | int | 是 | 用戶投訴次數。用戶首次發(fā)起投訴記為1次,用戶每有一次繼續(xù)投訴就加1 示例值:1 |
問題類型 | problem_type | string | 否 | 問題類型為申請退款的單據是需要最高優(yōu)先處理的單據 REFUND:申請退款 SERVICE_NOT_WORK:服務權益未生效 OTHERS:其他類型 示例值:REFUND |
申請退款金額 | apply_refund_amount | int | 否 | 僅當問題類型為申請退款時, 有值, (單位:分) 示例值:10 |
用戶標簽列表 | user_tag_list | array | 否 | 用戶標簽列表 TRUSTED:可信,此類用戶滿足極速退款條件 OTHERS:其它,此類用戶不滿足極速退款條件 示例值:[TRUSTED] |
+ 補充信息 | additional_info | object | 否 | 用在特定行業(yè)或場景下返回的補充信息 |
{
"complaint_id": "200201820200101080076610000",
"complaint_time": "2015-05-20T13:29:35.120+08:00",
"complaint_detail": "反饋一個重復扣費的問題",
"complainted_mchid": 1900012181,
"complaint_state": "PENDING",
"payer_phone": "sGdNeTHMQGlxCWiUyHu6XNO9GCYln2Luv4HhwJzZBfcL12sB",
"payer_openid": "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o",
"complaint_media_list": [{
"media_type": "USER_COMPLAINT_IMAGE",
"media_url": [
"https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
]
}],
"complaint_order_info": [{
"transaction_id": "4200000404201909069117582536",
"out_trade_no": "20190906154617947762231",
"amount": 3
}],
"service_order_info": [
{
"order_id": "15646546545165651651",
"out_order_no": "1234323JKHDFE1243252",
"state": "DOING"
}
]
"complaint_full_refunded": true,
"incoming_user_response": true,
"problem_description": "不滿意商家服務",
"user_complaint_times": 1,
"additional_info": {
"share_power_info": {
"return_time": "2023-02-10T14:44:00+08:00"
},
"type": "SHARE_POWER_TYPE"
}
}
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 5開頭的狀態(tài)碼都為系統(tǒng)問題,請使用相同參數稍后重新調用 |
400 | PARAM_ERROR | 參數錯誤 | 請根據錯誤提示,傳入正確參數 |
400 | INVALID_REQUEST | 請求參數符合參數格式,但不符合業(yè)務規(guī)則項 | 請確認參數符合業(yè)務要求,稍后重新調用 |
401 | SIGN_ERROR | 簽名驗證失敗 | 請檢查簽名參數和方法是否都符合簽名算法要求 |
403 | NO_AUTH | 無權限 | 請開通商戶號權限,并確認參數符合規(guī)范 |
429 | FREQUENCY_LIMITED | 頻率超限 | 請求量不要超過接口調用頻率限制 |