微信投訴處理-接入指引
最近更新時間：2023.7.17
1.產(chǎn)品介紹
1.1簡介
斗拱為渠道商/商戶提供一套在微信側(cè)進(jìn)行消費(fèi)者投訴模塊的申訴處理功能，在渠道商/商戶登陸控臺后使用該功能可大大減少在微信側(cè)的交互。
1.2相關(guān)能力應(yīng)用場景
查詢渠道在微信被投訴的記錄，包括兩部分：
- 被投訴的清單列表；
- 商戶調(diào)用此接口，查詢指定時間段的所有用戶投訴信息，以分頁輸出查詢結(jié)果。
- 服務(wù)商、渠道商調(diào)用此接口，查詢指定特約商戶號下的投訴信息。若不指定，則查詢的是名下所有特約商戶投訴信息。
- 單筆投訴單的詳細(xì)信息；查詢指定投訴單的用戶投訴詳情，包含投訴關(guān)聯(lián)訂單信息/支付分服務(wù)單信息、投訴的問題類型、問題描述、投訴人聯(lián)系方式等信息，方便商戶處理投訴。
1.3適用對象
微信的渠道商。微信要求如果不及時處理投訴單渠道商會被降級。
2.接入前準(zhǔn)備
3.開發(fā)指引
3.1對接規(guī)范
- 請求方式：POST
- 支持格式：JSON
- 加簽驗(yàn)簽說明：請參考接入指引-開發(fā)指南
3.2系統(tǒng)接口
3.2.1查詢投訴單列表及詳情
入?yún)⑿桕P(guān)注以下字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| sys_id | 商戶/渠道商匯付Id | 渠道商/商戶在匯付側(cè)分配的id |
| huifu_id | 被投訴的商戶ID | |
| transaction_id | 微信訂單號 | 示例值：4200001625202210202723751004；有值查指定訂單號的投訴信息，為空則查詢商戶下的所有投訴信息 |
| complaint_id | 微信投訴訂單號 | 示例值：200000020221020130032510333；有值查指定投訴單號的投訴信息，為空則查詢商戶下的所有投訴信息 |
| complaint_state | 投訴狀態(tài) | 待處理：待處理，PROCESSING：處理中，PROCESSED：已處理完成 |
返參需關(guān)注以下字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| total_count | 投訴總條數(shù) | 條數(shù)過多需要分頁處理 |
| complaint_list | 用戶投訴詳情 | 包括：投訴單號、投訴詳情、投訴時間等 |
3.2.2查詢投訴協(xié)商歷史
入?yún)⑿桕P(guān)注以下字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| complaint_id | 微信投訴訂單號 | 示例值：200000020221020130032510333；有值查指定投訴單號的投訴信息，為空則查詢商戶下的所有投訴信息 |
| mch_id | 微信商戶號 | 微信從業(yè)機(jī)構(gòu)號 |
返參需關(guān)注以下字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| total_count | 投訴總條數(shù) | 條數(shù)過多需要分頁處理 |
| complaint_history_list | 投訴協(xié)商歷史 | 包括投訴資料列表（內(nèi)涵圖片文件信息）、操作內(nèi)容等 |
3.3.3回復(fù)用戶
入?yún)⑿桕P(guān)注以下字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| complaint_id | 微信投訴訂單號 | 示例值：200000020221020130032510333；有值查指定投訴單號的投訴信息，為空則查詢商戶下的所有投訴信息 |
| complainted_mchid | 被投訴微信商戶號 | 被投訴的微信商戶號 |
| response_content | 回復(fù)內(nèi)容 | 回復(fù)具體的解決方案，200字符以內(nèi) |
| mch_id | 微信商戶號 | 微信從業(yè)機(jī)構(gòu)號 |
| file_info | 文件列表 | 最多可上傳4張圖片 |
返參需關(guān)注以下字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| resp_desc | 返回描述 |
3.3.4反饋處理完成
入?yún)⑿桕P(guān)注以下字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| complaint_id | 微信投訴訂單號 | 示例值：200000020221020130032510333；有值查指定投訴單號的投訴信息，為空則查詢商戶下的所有投訴信息 |
| complainted_mchid | 被投訴微信商戶號 | 被投訴的微信商戶號 |
| mch_id | 微信商戶號 | 微信從業(yè)機(jī)構(gòu)號 |
返參需關(guān)注以下字段：
| 參數(shù) | 中文名 | 說明 |
|---|---|---|
| resp_desc | 返回描述 |
4.API列表
| 類型 | 功能 | 描述 |
|---|---|---|
| 應(yīng)用程序接口 | 查詢投訴單列表及詳情 | 查詢渠道在微信被投訴的記錄 |
| 應(yīng)用程序接口 | 查詢投訴協(xié)商歷史 | 商戶可通過調(diào)用此接口，查詢指定投訴單的用戶與商戶的協(xié)商歷史，以分頁輸出查詢結(jié)果，方便商戶根據(jù)處理歷史來制定后續(xù)處理方案。 |
| 應(yīng)用程序接口 | 投訴圖片下載 | 消費(fèi)者投訴相關(guān)圖片都可以通過該接口進(jìn)行下載。 |
| 應(yīng)用程序接口 | 回復(fù)用戶 | 商戶可通過調(diào)用此接口，提交內(nèi)容回復(fù)用戶。 |
| 應(yīng)用程序接口 | 更新退款審批結(jié)果 | 商戶可通過調(diào)用此接口，更新"申請退款"單據(jù)的退款審批結(jié)果。 |
| 應(yīng)用程序接口 | 反饋處理完成 | 商戶可通過調(diào)用此接口，反饋投訴單已處理完成。 |
