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

條件查詢批次列表API

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


通過此接口可查詢多個(gè)批次的信息，包括批次的配置信息以及批次概況數(shù)據(jù)。

接口說明

適用對(duì)象：直連商戶 服務(wù)商 渠道商

請(qǐng)求URL：https://api.mch.weixin.qq.com/v3/marketing/favor/stocks

請(qǐng)求方式：GET

接口規(guī)則：http://www.tg885.com/wiki/doc/apiv3/wechatpay/wechatpay-1.shtml


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

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

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


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

參數(shù)名 變量 類型[長(zhǎng)度限制] 必填 描述
分頁頁碼 offset uint32 是 query 頁碼從0開始，默認(rèn)第0頁。
示例值：1
分頁大小 limit uint32 是 query 分頁大小，最大10。
示例值：8
創(chuàng)建批次的商戶號(hào) stock_creator_mchid string[1,20] 是 query 批次創(chuàng)建方商戶號(hào)。
示例值：9856888
起始時(shí)間 create_start_time string[1,64] 否 query 起始創(chuàng)建時(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年5月20日 13點(diǎn)29分35秒。
示例值：2015-05-20T13:29:35.120+08:00
終止時(shí)間 create_end_time string[1,64] 否 query 終止創(chuàng)建時(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年5月20日 13點(diǎn)29分35秒。
示例值：2015-05-20T13:29:35.120+08:00
批次狀態(tài) status string[1,12] 否 query 批次狀態(tài)，枚舉值：
unactivated：未激活
audit：審核中
running：運(yùn)行中
stoped：已停止
paused：暫停發(fā)放
示例值：paused

請(qǐng)求示例


https://api.mch.weixin.qq.com/v3/marketing/favor/stocks？offset=1&limit=8&stock_creator_mchid=9856888&create_start_time=2015-05-20T13:29:35.120+08:00&create_end_time=2015-05-20T13:29:35.120+08:00&status=paused


    
｛
JAVA示例代碼
｝

返回參數(shù)

參數(shù)名 變量 類型[長(zhǎng)度限制] 必填 描述
批次總數(shù) total_count int64 是 經(jīng)過條件篩選，查詢到的批次總數(shù)量。
示例值：10
+ 批次詳情 data object 否 批次詳情
參數(shù)名 變量 類型[長(zhǎng)度限制] 必填 描述
批次號(hào) stock_id string[1,20] 是 微信為每個(gè)代金券批次分配的唯一id。
示例值：9836588
創(chuàng)建批次的商戶號(hào) stock_creator_mchid string[1,20] 是 微信為創(chuàng)建方商戶分配的商戶號(hào)。
示例值：123456
批次名稱 stock_name string[1,20] 是 批次名稱
示例值：微信支付批次
批次狀態(tài) status string[1,16] 是 批次狀態(tài)，枚舉值：
unactivated：未激活
audit：審核中
running：運(yùn)行中
stoped：已停止
paused：暫停發(fā)放
示例值：paused
創(chuàng)建時(shí)間 create_time string[1,32] 是 批次創(chuàng)建時(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年5月20日 13點(diǎn)29分35秒。
示例值：2015-05-20T13:29:35.120+08:00
使用說明 description string[1,3000] 是 批次描述信息
示例值：微信支付營(yíng)銷
+ 滿減券批次使用規(guī)則 stock_use_rule

object

 否 普通發(fā)券批次特定信息。
參數(shù)名 變量 類型[長(zhǎng)度限制] 必填 描述
發(fā)放總上限 max_coupons uint64 是 最大發(fā)券數(shù)
示例值：100
總預(yù)算 max_amount uint64 是 總消耗金額，單位：分。
示例值：5000
單天發(fā)放上限金額 max_amount_by_day uint64 是 單天最高消耗金額，單位：分。
示例值：400
+ 固定面額批次特定信息 fixed_normal_coupon

object

 否 固定面額發(fā)券批次特定信息。
參數(shù)名 變量 類型[長(zhǎng)度限制] 必填 描述
面額 coupon_amount uint64 是 面額，單位：分。
示例值：100
門檻 transaction_minimum uint64 是 使用券金額門檻，單位：分。
示例值：100
單個(gè)用戶可領(lǐng)個(gè)數(shù) max_coupons_per_user uint32 是 單個(gè)用戶可領(lǐng)個(gè)數(shù)
示例值：3
券類型 coupon_type string[1,16] 否 枚舉值：
NORMAL：滿減券
CUT_TO：減至券
示例值：NORMAL
訂單優(yōu)惠標(biāo)記 goods_tag array 否 訂單優(yōu)惠標(biāo)記
特殊規(guī)則：?jiǎn)蝹€(gè)優(yōu)惠標(biāo)記的字符長(zhǎng)度為【1，128】,條目個(gè)數(shù)限制為【1，50】。
示例值：{'123456','23456'}
支付方式 trade_type string[1,16] 是 默認(rèn)不限制，枚舉值：
MICROAPP：小程序支付
APPPAY：APP支付
PPAY：免密支付
CARD：付款碼支付
FACE：人臉支付
OTHER：（公眾號(hào)、掃碼等）
示例值：APPPAY
是否可疊加其他優(yōu)惠 combine_use bool 否 枚舉值：
true：是
false：否
示例值：true
可用開始時(shí)間 available_begin_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年5月20日 13點(diǎn)29分35秒。
示例值：2015-05-20T13:29:35.120+08:00
可用結(jié)束時(shí)間 available_end_time string[1,32] 是 可用結(jié)束時(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年5月20日 13點(diǎn)29分35秒。
示例值：2015-05-20T13:29:35.120+08:00
已發(fā)券數(shù)量 distributed_coupons uint32 是 已發(fā)券數(shù)量
示例值：100
是否無資金流 no_cash bool 是 是否無資金流。枚舉值：
ture：是
false：否
示例值：true
激活批次的時(shí)間 start_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年5月20日 13點(diǎn)29分35秒。
示例值：2015-05-20T13:29:35.120+08:00
終止批次的時(shí)間 stop_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年5月20日 13點(diǎn)29分35秒。
示例值：2015-05-20T13:29:35.120+08:00
+ 減至批次特定信息 cut_to_message object 否 單品優(yōu)惠特定信息。
參數(shù)名 變量 類型[長(zhǎng)度限制] 必填 描述
可用優(yōu)惠的商品最高單價(jià) single_price_max uint64 是 可用優(yōu)惠的商品最高單價(jià)，單位：分。
示例值：100
減至后的優(yōu)惠單價(jià) cut_to_price uint64 是 減至后的優(yōu)惠單價(jià)，單位：分。
示例值：100
是否單品優(yōu)惠 singleitem bool 是 枚舉值：
true：是
false：否
示例值：true
批次類型 stock_type string[1,16]
 是 批次類型
枚舉值：
NORMAL：代金券批次
DISCOUNT_CUT：立減與折扣
OTHER：其他
示例值：NORMAL
分頁大小 limit uint32 是 分頁大小，最大10。
示例值：8
分頁頁碼 offset uint32 是 頁碼從0開始，默認(rèn)第0頁。
示例值：1

返回示例


{
	"total_count": 10,
	"data": [{
		"stock_id": "9836588",
		"stock_creator_mchid": "123456",
		"stock_name": "微信支付批次",
		"status": "paused",
		"create_time": "2015-05-20T13:29:35.120+08:00",
		"description": "微信支付營(yíng)銷",
		"stock_use_rule": {
			"max_coupons": 100,
			"max_amount": 5000,
			"max_amount_by_day": 400,
			"fixed_normal_coupon": {
				"coupon_amount": 100,
				"transaction_minimum": 100
			},
			"max_coupons_per_user": 3,
			"trade_type": "APPPAY",
		},
		"available_begin_time": "2015-05-20T13:29:35.120+08:00",
		"available_end_time": "2015-05-20T13:29:35.120+08:00"
		"distributed_coupons": 100,
		"no_cash": true,
		"singleitem ": true,
		"stock_type": "NORMAL",
	}],
	"limit": 8,
	"offset": 1
}
                                

    http://2323weixin.qq.com

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

狀態(tài)碼 錯(cuò)誤碼 描述 解決方案
400 PARAM_ERROR 回調(diào)url不能為空 請(qǐng)?zhí)顚懟卣{(diào)url
PARAM_ERROR 回調(diào)商戶不能為空 請(qǐng)?zhí)顚懟卣{(diào)商戶
PARAM_ERROR 券id必填 請(qǐng)?zhí)顚懭痠d
PARAM_ERROR appid必填 請(qǐng)輸入appid
PARAM_ERROR openid必填 請(qǐng)輸入openid
PARAM_ERROR 頁大小超過閾值 請(qǐng)不要超過最大的頁大小
PARAM_ERROR 輸入時(shí)間格式錯(cuò)誤 請(qǐng)輸入正確的時(shí)間格式
PARAM_ERROR 批次號(hào)必填 請(qǐng)輸入批次號(hào)
PARAM_ERROR 商戶號(hào)必填 請(qǐng)輸入商戶號(hào)
PARAM_ERROR 非法的批次狀態(tài) 請(qǐng)檢查批次狀態(tài)
400 MCH_NOT_EXISTS 商戶號(hào)不合法 請(qǐng)輸入正確的商戶號(hào)
400 INVALID_REQUEST openid與appID不匹配 請(qǐng)使用appID下的的openid
INVALID_REQUEST 活動(dòng)已結(jié)束或未激活 請(qǐng)檢查批次狀態(tài)
INVALID_REQUEST 非法的商戶號(hào) 請(qǐng)檢查商戶號(hào)是否正確
400 APPID_MCHID_NOT_MATCH 商戶號(hào)與appid不匹配 請(qǐng)綁定調(diào)用接口的商戶號(hào)和APPID后重試
403 USER_ACCOUNT_ABNORMAL 用戶非法 該用戶賬號(hào)異常，無法領(lǐng)券。商家可聯(lián)系微信支付或讓用戶聯(lián)系微信支付客服處理。
403 NOT_ENOUGH 批次預(yù)算不足 請(qǐng)補(bǔ)充預(yù)算
403 REQUEST_BLOCKED 調(diào)用商戶無權(quán)限 請(qǐng)開通產(chǎn)品權(quán)限后再調(diào)用該接口
REQUEST_BLOCKED 商戶無權(quán)發(fā)券 調(diào)用接口的商戶號(hào)無權(quán)發(fā)券，請(qǐng)檢查是否是自己的批次或是已授權(quán)的批次。
REQUEST_BLOCKED 批次不支持跨商戶發(fā)券 該批次未做跨商戶號(hào)的授權(quán)，請(qǐng)授權(quán)后再發(fā)放
REQUEST_BLOCKED 用戶被限領(lǐng)攔截 用戶領(lǐng)取已經(jīng)達(dá)到上限，請(qǐng)調(diào)高上限或停止發(fā)放。
404 RESOURCE_NOT_EXISTS 批次不存在 請(qǐng)檢查批次ID是否正確
429 FREQUENCY_LIMIT_EXCEED 接口限頻 請(qǐng)降低調(diào)用頻率

版本說明

關(guān)閉
V1.0
2019年09月27日
1. 條件查詢批次列表接口上線

技術(shù)咨詢

文檔反饋