商戶可通過調(diào)用此接口,查詢指定投訴單的用戶投訴詳情,包含投訴關(guān)聯(lián)訂單信息、支付分服務(wù)單信息、投訴的問題類型、問題描述、投訴人聯(lián)系方式等信息,方便商戶處理投訴。
# 接口說明
支持商戶:
【普通服務(wù)商】【從業(yè)機構(gòu)(銀行)】【從業(yè)機構(gòu)(支付機構(gòu))】【渠道商】【清算機構(gòu)】
請求方式:
【GET】/v3/merchant-service/complaints-v2/{complaint_id}
請求域名:
【主域名】
https://api.mch.weixin.qq.com
使用該域名將訪問就近的接入點【備域名】
https://api2.mch.weixin.qq.com
使用該域名將訪問異地的接入點 ,指引點擊查看
# 請求參數(shù)
- Authorization 必填 string請參考 簽名認(rèn)證 生成認(rèn)證信息
- Accept 必填 string請設(shè)置為
application/json
Header HTTP頭參數(shù)
- complaint_id 必填 string(64)【投訴單號】 投訴單對應(yīng)的投訴單號
Path 路徑參數(shù)
請求示例
GET
# 應(yīng)答參數(shù)
- complaint_id 必填 string(64)【投訴單號】 投訴單對應(yīng)的投訴單號
- complaint_time 必填 string(32)【投訴時間】 投訴時間
- complaint_detail 必填 string(300)【投訴詳情】 投訴的具體描述
- complaint_state 必填 string(30)【投訴單狀態(tài)】 標(biāo)識當(dāng)前投訴單所處的處理階段,具體狀態(tài)如下所示:
PENDING-待處理
PROCESSING-處理中
PROCESSED-已處理完成 - complainted_mchid 必填 string(64)【被訴商戶號】 當(dāng)服務(wù)商或渠道商查詢時返回,具體的子商戶標(biāo)識。
- payer_phone 選填 string(512)【投訴人聯(lián)系方式】 投訴人聯(lián)系方式。該字段已做加密處理,具體解密方法詳見敏感信息加密說明。
- payer_openid 選填 string(128)【投訴人OpenID】 投訴人在商戶AppID下的唯一標(biāo)識,支付分服務(wù)單類型無
- complaint_order_info 選填 array[ComplaintOrderInfo]【投訴單關(guān)聯(lián)訂單信息】 投訴單關(guān)聯(lián)訂單信息
- 屬性
- complaint_full_refunded 必填 boolean【投訴單是否已全額退款】 投訴單下所有訂單是否已全部全額退款
- incoming_user_response 必填 boolean【是否有待回復(fù)的用戶留言】 投訴單是否有待回復(fù)的用戶留言
- user_complaint_times 必填 integer【用戶投訴次數(shù)】 用戶投訴次數(shù)。用戶首次發(fā)起投訴記為1次,用戶每有一次繼續(xù)投訴就加1
- complaint_media_list 選填 array[ComplaintMedia]【投訴資料列表】 用戶上傳的投訴相關(guān)資料,包括圖片憑證等
- 屬性
- problem_description 必填 string(256)【問題描述】 用戶發(fā)起投訴前選擇的faq標(biāo)題(2021年7月15日之后的投訴單均包含此信息)
- problem_type 選填 string【問題類型】 問題類型為申請退款的單據(jù)是需要最高優(yōu)先處理的單據(jù)
可選取值:REFUND
: 申請退款SERVICE_NOT_WORK
: 服務(wù)權(quán)益未生效OTHERS
: 其他類型
- apply_refund_amount 選填 integer【申請退款金額】 僅當(dāng)問題類型為申請退款時, 有值, (單位:分)
- user_tag_list 選填 array[string]【用戶標(biāo)簽列表】 用戶標(biāo)簽列表
可選取值:TRUSTED
: 此類用戶滿足極速退款條件HIGH_RISK
: 高風(fēng)險投訴,請按照運營要求優(yōu)先妥善處理
- service_order_info 選填 array[ServiceOrderInfo]【投訴單關(guān)聯(lián)服務(wù)單信息】
- 屬性
- additional_info 選填 AdditionalInfo【補充信息】 用在特定行業(yè)或場景下返回的補充信息
- 屬性
- in_platform_service 選填 boolean【是否在平臺協(xié)助中】 標(biāo)識當(dāng)前投訴單是否正處在平臺協(xié)助流程中。注:在協(xié)助期間由微信支付客服為用戶服務(wù),期間商戶向用戶發(fā)送的留言用戶不可見
- need_immediate_service 選填 boolean【是否需即時服務(wù)用戶】 因用戶訴求緊急度、用戶界面差異等因素,部分投訴單建議商戶更即時地響應(yīng)用戶訴求。如此處標(biāo)識為“是”,建議商戶提升服務(wù)時效,給用戶帶來更好的體驗
200OK
應(yīng)答示例
200 OK
# 錯誤碼
# 公共錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | PARAM_ERROR | 參數(shù)錯誤 | 請根據(jù)錯誤提示正確傳入?yún)?shù) |
400 | INVALID_REQUEST | HTTP 請求不符合微信支付 APIv3 接口規(guī)則 | 請參閱 接口規(guī)則 |
401 | SIGN_ERROR | 驗證不通過 | 請參閱 簽名常見問題 |
500 | SYSTEM_ERROR | 系統(tǒng)異常,請稍后重試 | 請稍后重試 |
# 業(yè)務(wù)錯誤碼
狀態(tài)碼 | 錯誤碼 | 描述 | 解決方案 |
---|---|---|---|
400 | INVALID_REQUEST | 請求參數(shù)符合參數(shù)格式,但不符合業(yè)務(wù)規(guī)則項 | 請確認(rèn)參數(shù)符合業(yè)務(wù)要求,稍后重新調(diào)用 |
403 | NO_AUTH | 無權(quán)限 | 請開通商戶號權(quán)限,并確認(rèn)參數(shù)符合規(guī)范 |
429 | FREQUENCY_LIMITED | 頻率超限 | 請求量不要超過接口調(diào)用頻率限制 |
500 | SYSTEM_ERROR | 系統(tǒng)錯誤 | 5開頭的狀態(tài)碼都為系統(tǒng)問題,請使用相同參數(shù)稍后重新調(diào)用 |