查询营销补差付款单详情

更新时间：2026.01.12

查询商家券营销补差付款单详情

接口说明

适用对象：服务商

请求URL：https://api.mch.weixin.qq.com/v3/marketing/busifavor/subsidy/pay-receipts/{subsidy_receipt_id}

请求方式：GET

path 指该参数为路径参数

query 指该参数为URL参数

body 指该参数需在请求JSON传参

请求参数

参数名	变量	类型[长度限制]	必填	描述
补差付款单号	subsidy_receipt_id	string[28, 32]	是	path 补差付款唯一单号，由微信支付生成，仅在补差付款成功后有返回示例值：1120200119165100000000000001

请求示例

1https://api.mch.weixin.qq.com/v3/marketing/busifavor/subsidy/pay-receipts/1120200119165100000000000001

返回参数

参数名	变量	类型[长度限制]	必填	描述
补差付款单号	subsidy_receipt_id	string[28, 32]	是	补差付款唯一单号，由微信支付生成，仅在补差付款成功后有返回示例值：1120200119165100000000000001
商家券批次号	stock_id	string[1, 20]	是	由微信支付生成，调用创建商家券API成功时返回的唯一批次ID 示例值：128888000000001
商家券Code	coupon_code	string[1, 128]	是	券的唯一标识示例值：ABCD12345678
微信支付订单号	transaction_id	string[28, 32]	是	微信支付下单支付成功返回的订单号示例值：4200000913202101152566792388
营销补差扣款商户号	payer_merchant	string[1, 32]	是	营销补差扣款商户号示例值：1900000001
营销补差入账商户号	payee_merchant	string[1, 32]	是	营销补差入账商户号示例值：1900000002
补差付款金额	amount	int	是	单位为分，单笔订单补差金额不得超过券的优惠金额，最高补差金额为5000元 > 券的优惠金额定义：满减券：满减金额即为优惠金额换购券：不支持示例值：100
补差付款描述	description	string[1, 1024]	是	付款备注描述，查询的时候原样带回示例值：20210115DESCRIPTION
补差付款单据状态	status	string[1, 32]	是	补差付款单据状态： ACCEPTED：受理成功 SUCCESS：补差补款成功 FAIL：补差付款失败 RETURNING：补差回退中 PARTIAL_RETURN：补差部分回退 FULL_RETURN：补差全额回退示例值：SUCCESS
补差付款失败原因	fail_reason	string[1, 1024]	否	仅在补差付款失败时，返回告知对应失败的原因： INSUFFICIENT_BALANCE：扣款商户余额不足 NOT_INCOMESPLIT_ORDER：非分账订单 EXCEED_SUBSIDY_AMOUNT_QUOTA：超出订单补差总额限制 EXCEED_SUBSIDY_COUNT_QUOTA：超出订单补差总数限制 OTHER：其他原因示例值：INSUFFICIENT_BALANCE
补差付款完成时间	success_time	string[28, 32]	否	仅在补差付款成功时，返回完成时间。遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日， T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.+08:00表示，北京时间2015年5月20日 13点29分35秒。示例值：2021-01-20T10:29:35+08:00
业务请求唯一单号	out_subsidy_no	string[1, 128]	是	商户侧需保证唯一性。可包含英文字母，数字，｜，_，*，-等内容，不允许出现其他不合法符号示例值：subsidy-abcd-12345678
补差付款发起时间	create_time	string[28, 32]	否	补差付款单据创建时间。遵循rfc3339标准格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日， T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC 8小时，即北京时间）。例如：2015-05-20T13:29:35.+08:00表示，北京时间2015年5月20日 13点29分35秒。示例值：2021-01-20T10:29:35+08:00

返回示例

1{
2  "subsidy_receipt_id": "1120200119165100000000000001",
3  "stock_id": "128888000000001",
4  "coupon_code": "ABCD12345678",
5  "transaction_id": "4200000913202101152566792388",
6  "payer_merchant": "1900000001",
7  "payee_merchant": "1900000002",
8  "amount": 100,
9  "description": "20210115DESCRIPTION",
10  "status": "SUCCESS",
11  "success_time": "2021-01-20T10:29:35.120+08:00",
12  "out_subsidy_no": "subsidy-abcd-12345678",
13  "create_time": "2021-01-20T10:29:35.120+08:00"
14}

错误码

公共错误码

状态码	错误码	描述	解决方案
400	PARAM_ERROR	参数错误	查看具体错误信息，调整参数
500	SYSTEM_ERROR	系统错误	多为网络超时引起，请使用相同参数稍后重新调用
401	SIGN_ERROR	签名验证失败	请检查签名参数和方法是否都符合签名算法要求
429	FREQUENCY_LIMITED	频率限制	调用太频繁，请降低调用接口频率
404	NOT_FOUND	单据不存在	请检查补差付款单号是否填写正确

文档是否有帮助

LLM请查看llms.txt

开发文档(商户)开发文档(V2版)开发者社区微信开放平台微信公众平台腾讯客服