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