最新更新時間:2020.11.27 版本說明
商戶可通過調(diào)用此接口,查詢指定投訴的用戶投訴詳情,包含投訴內(nèi)容、投訴訂單、投訴人聯(lián)系方式等信息,方便商戶獲取投訴詳情處理投訴。
1、接口已經(jīng)從目前的V1.0版本升級到V2.0版本,請盡快升級,2.0版本文檔請查閱。
2、V1.0版本接口將繼續(xù)運營一段時間,具體下線時間請關(guān)注商戶平臺公告和微信支付郵件
3、V1.0版接口與V2.0版本接口區(qū)別說明
適用對象:直連商戶
請求URL:https://api.mch.weixin.qq.com/v3/merchant-service/complaints/{transaction_id}
請求方式:GET
path 指該參數(shù)為路徑參數(shù)
query 指該參數(shù)為URL參數(shù)
body 指該參數(shù)需在請求JSON傳參
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
微信支付訂單號 | transaction_id | string[1, 64] | 是 | path投訴單對應的微信訂單號 示例值:4200000404201909069117582536 |
https://api.mch.weixin.qq.com/v3/merchant-service/complaints/4200000404201909069117582536
參數(shù)名 | 變量 | 類型[長度限制] | 必填 | 描述 |
---|---|---|---|---|
商戶訂單號 | out_trade_no | string[1, 64] | 是 | 投訴對應的商戶訂單號 示例值:20190906154617947762231 |
投訴時間 | 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ū)時間,領(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] | 是 | 投訴具體描述。 示例值:反饋一個重復扣費的問題 |
投訴單狀態(tài) | complaint_state | string[1, 30] | 否 | 投訴狀態(tài)(已廢棄)。用于標識當前投訴單的狀態(tài),針對投訴單本身。既包括用戶投訴、撤訴,也包括商戶未能及時解決投訴帶來的資金相關(guān)的投訴狀態(tài)。 枚舉值: |
微信支付訂單號 | transaction_id | string[1, 64] | 是 | 投訴對應的微信訂單號 示例值:4200000404201909069117582536 |
凍結(jié)結(jié)束時間 | frozen_end_time | string[1, 32] | 否 | 若該投訴涉及資金凍結(jié),則此字段表示凍結(jié)結(jié)束時間。
遵循rfc3339標準格式,格式為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] | 否 | 當服務商或渠道商查詢時返回,返回具體被投訴子商戶的商戶號。 示例值:1900012181 |
投訴單處理進展狀態(tài) | complaint_handle_state | string[1, 64] | 是 | 投訴單處理進展狀態(tài),標識當前投訴單所處的處理階段,描述用戶與商戶的溝通反饋進度,將逐步取代投訴狀態(tài)。 具體狀態(tài)如下所示: WAIT_MERCHANT_RESPONSE:待商戶處理 MERCHANT_RESPONSED:商戶已反饋 USER_CONFIRMED:用戶已確認 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": "反饋一個重復扣費的問題",
"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è)務規(guī)則項 | 請確認參數(shù)符合業(yè)務要求,稍后重新調(diào)用 |
401 | SIGN_ERROR | 簽名驗證失敗 | 請檢查簽名參數(shù)和方法是否都符合簽名算法要求 |
403 | NO_AUTH | 商戶暫無權(quán)限使用此功能 | 請開通商戶號權(quán)限。請聯(lián)系產(chǎn)品或商務申請 |
429 | FREQUENCY_LIMITED | 頻率超限 | 請求量不要超過接口調(diào)用頻率限制 |