微信支付-開發(fā)者文檔

返回上一層文檔首頁 / 查詢投訴單列表API

查詢投訴單列表API

最新更新時(shí)間：2023.03.07 版本說明

商戶可通過調(diào)用此接口，查詢指定時(shí)間段的所有用戶投訴信息，以分頁輸出查詢結(jié)果。對(duì)于服務(wù)商、渠道商，可通過調(diào)用此接口，查詢指定特約商戶號(hào)下的投訴信息，若不指定，則查詢的是名下所有特約商戶投訴信息。

接口說明

適用對(duì)象：直連商戶

請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/merchant-service/complaints-v2

請(qǐng)求方式：GET

path 指該參數(shù)為路徑參數(shù)

query 指該參數(shù)為URL參數(shù)

body 指該參數(shù)需在請(qǐng)求JSON傳參

請(qǐng)求參數(shù)

參數(shù)名	變量	類型[長度限制]	必填	描述
分頁大小	limit	int	否	query設(shè)置該次請(qǐng)求返回的最大投訴條數(shù)，范圍【1,50】,商戶自定義字段，不傳默認(rèn)為10。注：如遇到提示“當(dāng)前查詢結(jié)果數(shù)據(jù)量過大”，是回包觸發(fā)微信支付下行數(shù)據(jù)包大小限制，請(qǐng)縮小入?yún)imit并重試。示例值：5
分頁開始位置	offset	int	否	query該次請(qǐng)求的分頁開始位置，從0開始計(jì)數(shù)，例如offset=10，表示從第11條記錄開始返回，不傳默認(rèn)為0 。示例值：10
開始日期	begin_date	string[10, 10]	是	query投訴發(fā)生的開始日期，格式為yyyy-MM-DD。注意，查詢?nèi)掌诳缍炔怀^30天，當(dāng)前查詢?yōu)閷?shí)時(shí)查詢示例值：2019-01-01
結(jié)束日期	end_date	string[10, 10]	是	query投訴發(fā)生的結(jié)束日期，格式為yyyy-MM-DD。注意，查詢?nèi)掌诳缍炔怀^30天，當(dāng)前查詢?yōu)閷?shí)時(shí)查詢示例值：2019-01-01
被訴商戶號(hào)	complainted_mchid	string[1, 64]	否	query投訴單對(duì)應(yīng)的被訴商戶號(hào)。示例值：1900012181

請(qǐng)求示例


https://api.mch.weixin.qq.com/v3/merchant-service/complaints-v2?limit=5&offset=10&begin_date=2019-01-01&end_date=2019-01-01&complainted_mchid=1900012181


｛
JAVA示例代碼
｝

返回參數(shù)

參數(shù)名

變量

類型[長度限制]

必填

描述

+ 用戶投訴詳情

data

array

否

用戶投訴信息詳情投訴單相關(guān)信息

參數(shù)名

變量

類型[長度限制]

必填

描述

投訴單號(hào)

complaint_id

string[1, 64]

是

投訴單對(duì)應(yīng)的投訴單號(hào)
示例值：200201820200101080076610000

投訴時(shí)間

complaint_time

string[1, 32]

是

投訴時(shí)間，遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss.sss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss.sss表示時(shí)分秒毫秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC 8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35.120+08:00表示北京時(shí)間2015年05月20日13點(diǎn)29分35秒。
示例值：2015-05-20T13:29:35.120+08:00

投訴詳情

complaint_detail

string[1, 300]

是

投訴的具體描述
示例值：反饋一個(gè)重復(fù)扣費(fèi)的問題

投訴單狀態(tài)

complaint_state

string[1, 30]

是

標(biāo)識(shí)當(dāng)前投訴單所處的處理階段，具體狀態(tài)如下所示：
PENDING：待處理
PROCESSING：處理中
PROCESSED：已處理完成
示例值：PENDING

投訴人聯(lián)系方式

payer_phone

string[1, 256]

是

投訴人聯(lián)系方式。該字段已做加密處理，具體解密方法詳見《詳見接口規(guī)則》。
示例值：Qe41VhP/sGdNeTHMQGlxCWiUyHu6XNO9GCYln2Luv4HhwJzZBfcL12sB+PgZcS5NhePBog30NgJ1xRaK+gbGDKwpg==

+ 投訴單關(guān)聯(lián)訂單信息

complaint_order_info

array

否

投訴單關(guān)聯(lián)訂單信息

參數(shù)名	變量	類型[長度限制]	必填	描述
微信訂單號(hào)	transaction_id	string[1, 64]	是	投訴單關(guān)聯(lián)的微信訂單號(hào) 示例值：4200000404201909069117582536
商戶訂單號(hào)	out_trade_no	string[1, 64]	是	投訴單關(guān)聯(lián)的商戶訂單號(hào) 示例值：20190906154617947762231
訂單金額	amount	int	是	訂單金額，單位（分）示例值：3

+ 投訴單關(guān)聯(lián)服務(wù)單信息

service_order_info

array

否

投訴單關(guān)聯(lián)服務(wù)單信息, 支付分服務(wù)單投訴時(shí)可能存在

參數(shù)名	變量	類型[長度限制]	必填	描述
微信支付服務(wù)訂單號(hào)	order_id	string[1, 128]	否	微信支付服務(wù)訂單號(hào)，每個(gè)微信支付服務(wù)訂單號(hào)與商戶號(hào)下對(duì)應(yīng)的商戶服務(wù)訂單號(hào)一一對(duì)應(yīng) 示例值：15646546545165651651
商戶服務(wù)訂單號(hào)	out_order_no	string[1, 128]	否	商戶系統(tǒng)內(nèi)部服務(wù)訂單號(hào)（不是交易單號(hào)），與創(chuàng)建訂單時(shí)一致示例值：1234323JKHDFE1243252
支付分服務(wù)單狀態(tài)	state	string	否	此處上傳的是用戶發(fā)起投訴時(shí)的服務(wù)單狀態(tài)，不會(huì)實(shí)時(shí)更新 DOING：服務(wù)訂單進(jìn)行中 REVOKED：商戶取消服務(wù)訂單 WAITPAY：服務(wù)訂單待支付 DONE：服務(wù)訂單已完成示例值：DOING

投訴單是否已全額退款

complaint_full_refunded

boolean

是

投訴單下所有訂單是否已全部全額退款
示例值：true

是否有待回復(fù)的用戶留言

incoming_user_response

boolean

是

投訴單是否有待回復(fù)的用戶留言
示例值：true

用戶投訴次數(shù)

user_complaint_times

int

是

用戶投訴次數(shù)。用戶首次發(fā)起投訴記為1次，用戶每有一次繼續(xù)投訴就加1
示例值：1

+ 投訴資料列表

complaint_media_list

array

否

用戶上傳的投訴相關(guān)資料，包括圖片憑證等

參數(shù)名	變量	類型[長度限制]	必填	描述
媒體文件業(yè)務(wù)類型	media_type	string	是	媒體文件對(duì)應(yīng)的業(yè)務(wù)類型 USER_COMPLAINT_IMAGE：用戶投訴圖片，用戶提交投訴時(shí)上傳的圖片憑證 OPERATION_IMAGE：操作流水圖片，用戶、商戶、微信支付客服在協(xié)商解決投訴時(shí)，上傳的圖片憑證示例值：USER_COMPLAINT_IMAGE
媒體文件請(qǐng)求url	media_url	array	否	微信返回的媒體文件請(qǐng)求url 示例值：https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx

問題描述

problem_description

string[1, 256]

是

用戶發(fā)起投訴前選擇的faq標(biāo)題（2021年7月15日之后的投訴單均包含此信息）
示例值：不滿意商家服務(wù)

問題類型

problem_type

string

否

問題類型為申請(qǐng)退款的單據(jù)是需要最高優(yōu)先處理的單據(jù)
REFUND：退款類型的問題投訴
SERVICE_NOT_WORK：服務(wù)權(quán)益未生效
OTHERS：其他類型
示例值：REFUND

申請(qǐng)退款金額

apply_refund_amount

int

否

僅當(dāng)問題類型為申請(qǐng)退款時(shí), 有值, (單位:分)
示例值：10

用戶標(biāo)簽列表

user_tag_list

array

否

用戶標(biāo)簽列表
TRUSTED：可信，此類用戶滿足極速退款條件
OTHERS：其它，此類用戶不滿足極速退款條件
示例值：[TRUSTED]

+ 補(bǔ)充信息

additional_info

object

否

用在特定行業(yè)或場景下返回的補(bǔ)充信息

參數(shù)名

變量

類型[長度限制]

必填

描述

補(bǔ)充信息類型

type

string

否

補(bǔ)充信息類型，枚舉值：
SHARE_POWER_TYPE：充電寶投訴相關(guān)行業(yè)
示例值：SHARE_POWER_TYPE

+充電寶投訴相關(guān)信息

share_power_info

object

否

當(dāng)type為充電寶投訴相關(guān)時(shí)有值

參數(shù)名	變量	類型[長度限制]	必填	描述
歸還時(shí)間	return_time	string	否	遵循rfc3339標(biāo)準(zhǔn)格式，格式為yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出現(xiàn)在字符串中，表示time元素的開頭，HH:mm:ss表示時(shí)分秒，TIMEZONE表示時(shí)區(qū)（+08:00表示東八區(qū)時(shí)間，領(lǐng)先UTC8小時(shí)，即北京時(shí)間）。例如：2015-05-20T13:29:35+08:00表示，北京時(shí)間2015年5月20日 13點(diǎn)29分35秒。示例值：2015-05-20T13:29:35+08:00

分頁大小

limit

int

是

設(shè)置該次請(qǐng)求返回的最大投訴條數(shù)，范圍[1,50]
示例值：5

分頁開始位置

offset

int

是

該次請(qǐng)求的分頁開始位置，從0開始計(jì)數(shù)，例如offset=10，表示從第11條記錄開始返回。
示例值：10

投訴總條數(shù)

total_count

int

否

投訴總條數(shù)，當(dāng)offset=0時(shí)返回
示例值：1000

返回示例

正常示例


{
  "data": [
    {
	"additional_info": {
                "share_power_info": {
                    "return_time": "2023-02-10T14:44:00+08:00"
                },
                "type": "SHARE_POWER_TYPE"
        },
      "complaint_id": "200201820200101080076610000",
      "complaint_time": "2015-05-20T13:29:35.120+08:00",
      "complaint_detail": "反饋一個(gè)重復(fù)扣費(fèi)的問題",
      "complaint_state": "PENDING",
      "payer_phone": "Qe41VhP/sGdNeTHMQGlxCWiUyHu6XNO9GCYln2Luv4HhwJzZBfcL12sB+PgZcS5NhePBog30NgJ1xRaK+gbGDKwpg==",
      "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,
      "user_complaint_times": 1,
      "complaint_media_list": [
	      {
			"media_type": "USER_COMPLAINT_IMAGE",
			"media_url": [
				"https://api.mch.weixin.qq.com/v3/merchant-service/images/xxxxx"
			]
		  }
	  ],
  	 "problem_description": "不滿意商家服務(wù)",
  	 "limit": 5,
  	 "offset": 10,
  	 "total_count": 1000
  
}


http://2323weixin.qq.com

錯(cuò)誤碼公共錯(cuò)誤碼

狀態(tài)碼	錯(cuò)誤碼	描述	解決方案
500	SYSTEM_ERROR	系統(tǒng)錯(cuò)誤	5開頭的狀態(tài)碼都為系統(tǒng)問題，請(qǐng)使用相同參數(shù)稍后重新調(diào)用
400	PARAM_ERROR	參數(shù)錯(cuò)誤	請(qǐng)根據(jù)錯(cuò)誤提示，傳入正確參數(shù)
403	NO_AUTH	商戶信息不合法	登錄商戶平臺(tái)核對(duì)，傳入正確信息
429	FREQUENCY_LIMITED	頻率超限	請(qǐng)求量不要超過接口調(diào)用頻率限制

视频一区二区三区自拍_千金肉奴隷1985未删减版在线观看_国产成人黄色视频在线播放_少女免费播放片高清在线观看_国产精品v欧美精品v

微信支付商戶平臺(tái)

查詢投訴單列表API

接口說明

請(qǐng)求參數(shù)

請(qǐng)求示例

返回參數(shù)

返回示例

錯(cuò)誤碼公共錯(cuò)誤碼