最新更新時間：2020.11.27 版本說明
商戶可通過調(diào)用此接口，查詢指定投訴的用戶投訴詳情，包含投訴內(nèi)容、投訴訂單、投訴人聯(lián)系方式等信息，方便商戶獲取投訴詳情處理投訴。
適用對象：直連商戶 服務(wù)商 渠道商
請求URL：https://api.mch.weixin.qq.com/v3/merchant-service/complaints/{transaction_id}
請求方式：get
接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 微信支付訂單號 | transaction_id | string[1, 64] | 是 | path投訴單對應(yīng)的微信訂單號
示例值：4200000404201909069117582536 |
https://api.mch.weixin.qq.com/v3/merchant-service/complaints/4200000404201909069117582536
| 參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
|---|---|---|---|---|
| 商戶訂單號 | out_trade_no | string[1, 64] | 是 | 投訴對應(yīng)的商戶訂單號
示例值：20190906154617947762231 |
| 投訴時間 | 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 |
| 投訴金額 | amount | int | 是 | 投訴金額，單位（分）
示例值：3 |
| 投訴人聯(lián)系方式 | payer_phone | string[1, 256] | 否 | 投訴人聯(lián)系方式，用戶投訴時填寫了手機號則返回，未填寫則不返回。該字段已做加密處理，具體解密方法詳見《敏感信息加密說明》。
示例值：Qe41VhP/sGdNeTHMQGlxCWiUyHu6XNO9GCYln2Luv4HhwJzZBfcL12sB+PgZcS5NhePBog30NgJ1xRaK+gbGDKwpg== |
| 投訴描述 | complaint_detail | string[1, 300] | 是 | 投訴具體描述。 示例值：反饋一個重復(fù)扣費的問題 |
| 投訴單狀態(tài) | complaint_state | string[1, 30] | 否 | 投訴狀態(tài)(已廢棄)。用于標(biāo)識當(dāng)前投訴單的狀態(tài)，針對投訴單本身。既包括用戶投訴、撤訴，也包括商戶未能及時解決投訴帶來的資金相關(guān)的投訴狀態(tài)。 枚舉值： |
| 微信支付訂單號 | transaction_id | string[1, 64] | 是 | 投訴對應(yīng)的微信訂單號
示例值：4200000404201909069117582536 |
| 凍結(jié)結(jié)束時間 | frozen_end_time | string[1, 32] | 否 | 若該投訴涉及資金凍結(jié)，則此字段表示凍結(jié)結(jié)束時間。
遵循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 |
| 特約商戶號 | sub_mchid | string[1, 64] | 否 | 當(dāng)服務(wù)商或渠道商查詢時返回，返回具體被投訴子商戶的商戶號。
示例值：1900012181 |
| 投訴單處理進展?fàn)顟B(tài) | complaint_handle_state | string[1, 64] | 是 | 投訴單處理進展?fàn)顟B(tài)，標(biāo)識當(dāng)前投訴單所處的處理階段，描述用戶與商戶的溝通反饋進度，將逐步取代投訴狀態(tài)。 具體狀態(tài)如下所示： WAIT_MERCHANT_RESPONSE：待商戶處理 MERCHANT_RESPONSED：商戶已反饋 USER_CONFIRMED：用戶已確認(rèn) TIME_OUT_CLOSED：投訴超時關(guān)閉 MERCHANT_FULL_REFUNDED：商戶全額退款 PAYER_CANCELED：用戶已撤訴 示例值：WAIT_MERCHANT_RESPONSE |
{
"out_trade_no": "20190906154617947762231",
"complaint_time": "2015-05-20T13:29:35.120+08:00",
"amount": 3,
"payer_phone": "Qe41VhP/sGdNeTHMQGlxCWiUyHu6XNO9GCYln2Luv4HhwJzZBfcL12sB+PgZcS5NhePBog30NgJ1xRaK+gbGDKwpg==",
"complaint_detail": "反饋一個重復(fù)扣費的問題",
"transaction_id": "4200000404201909069117582536",
"frozen_end_time": "2015-05-20T13:29:35.120+08:00",
"sub_mchid": "1900012181",
"complaint_handle_state": "WAIT_MERCHANT_RESPONSE"
}
| 狀態(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)限。請聯(lián)系產(chǎn)品或商務(wù)申請 |
| 429 | FREQUENCY_LIMITED | 頻率超限 | 請求量不要超過接口調(diào)用頻率限制 |