申请公益捐赠预算

更新时间:2025.07.10

申请公益捐赠预算
注:单个商户的接口频率限制为50次/s

接口说明

支持商户:【普通服务商】

请求方式:【POST】/v3/fund-app/mch-transfer/partner/charity-budget

请求域名:【主域名】https://api.mch.weixin.qq.com 使用该域名将访问就近的接入点

     【备域名】https://api2.mch.weixin.qq.com 使用该域名将访问异地的接入点 ,指引点击查看

请求参数

Header  HTTP头参数

 Authorization  必填 string

请参考签名认证生成认证信息


 Accept  必填 string

请设置为application/json


 Content-Type  必填 string

请设置为application/json


body  包体参数

 out_budget_no  必填   string(32)

【商户预算单号】 服务商系统内部预算单号,此参数只能由数字、大小写字母组成,在服务商系统内部唯一。


 sponsor_mchid  必填   string(32)

【出资商户号】 出资捐款的商户号。


 sponsor_subject_name  必填   string(64)

【出资企业主体名称】 出资捐款的企业主体。


 activity_name  必填   string(32)

【活动名称】 公益活动名称,同时会在出资商户确认出资时展示,字数不超过32个字 符。中英文数字均算作1个字符。


 activity_remark  必填   string(64)

【活动说明】 活动备注信息,用于描述活动时间等,同时会在出资商户确认出资时展示。 字数不超过64个字符。中英文数字均算作1个字符。


 amount  必填   integer

【预算总金额】 预先锁定的活动预算总金额,同时会在出资商户确认出资时展示,金额单位为“分”。


 notify_url  选填   string(256)

【回调地址】 接收预算锁定申请结果通知,通知url必须为公网可访问的URL,必须为HTTPS,不能携带参数,不填则不通知商户。

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/fund-app/mch-transfer/partner/charity-budget \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "out_budget_no" : "budget202506300102",
8    "sponsor_mchid" : "1900001109",
9    "sponsor_subject_name" : "腾讯控股有限公司",
10    "activity_name" : "公益企业配捐活动",
11    "activity_remark" : "公益活动开始于9月1日,帮助困难儿童筹款活动",
12    "amount" : 20000000,
13    "notify_url" : "https://www.weixin.qq.com/wxpay/pay.php"
14  }'
15

应答参数

200 OK

 sp_mchid  必填   string(32)

【服务商商户号】 服务商商户号


 out_budget_no  必填   string(32)

【商户预算单号】 服务商系统内部预算单号,此参数只能由数字、大小写字母组成,在服务商系统内部唯一。


 budget_id  必填   string(32)

【微信支付预算单号】 微信支付预算单号,微信系统返回的唯一标识。


 amount  必填   integer

【活动总金额】 活动预算总金额,单位为“分”。


 sponsor_mchid  必填   string(32)

【出资商户号】 出资商户号


 activity_name  必填   string(32)

【活动名称】 活动名称


 activity_remark  必填   string(64)

【活动说明】 活动说明


 state  必填   string

【预算单状态】 预算单状态

可选取值

  • PENDING:  待锁定,成功申请公益捐赠预算后,但出资商户未确认时,预算单返回该状态

  • LOCKED:  已锁定,出资商户成功确认预算单后,预算单会由PENDING转变为LOCKED状态

  • FINISHED:  已完成(终态),预算捐赠完成或者解锁后,预算单会由LOCKED转变为FINISHED状态

  • CLOSED:  已关闭(终态),预算单超时未被出资商户确认,状态会由PENDING转变为CLOSED状态

  • UNLOCKING:  待释放,受理解锁预算单成功后,预算单会由LOCKED转变为UNLOCKING状态


 confirm_url  选填   string(255)

【确认出资页面地址】 出资商户操作确认的商户平台页面地址,当state是PENDING时返回,供服务商提供跳转路径。


 remain_amount  选填   integer

【剩余预算金额】 剩余预算金额,仅当state是LOCKED时返回,单位为“分”。


 unlock_remark  选填   string(32)

【撤销说明】 预算解锁时,商户传入的解锁说明,仅当state是FINISHED时返回


 locked_time  选填   string

【资金锁定时间】 资金锁定时间,仅当state是LOCKED或FINISHED时返回,遵循rfc3339标准格式:yyyy-MM-DDThh:mm:ss+TIMEZONE


 finished_time  选填   string

【完成时间】 完成时间,仅当state是FINISHED时返回,遵循rfc3339标准格式:yyyy-MM-DDThh:mm:ss+TIMEZONE


 closed_time  选填   string

【关闭时间】 关闭时间,仅当state是CLOSED时返回,遵循rfc3339标准格式:yyyy-MM-DDThh:mm:ss+TIMEZONE


 unlocked_amount  选填   integer

【解锁金额】 预算解锁完成后,实际已解锁的金额,单位为“分”,仅当state是FINISHED时返回,若预算在解锁前已经用完,则解锁金额为0。


 closed_reason  选填   string

【预算关闭原因】 预算关闭原因,仅当state是CLOSED时返回

可选取值

  • MCH_OVERDUE_UNCONFIRMED:  商户超时未确认,系统自动关闭预算单

  • CLOSE_VIA_MCH_API:  商户通过API主动关闭未确认的预算单

应答示例

200 OK

1{
2  "sp_mchid" : "1900001109",
3  "out_budget_no" : "budget202506300102",
4  "budget_id" : "1182020050700019480001",
5  "amount" : 20000000,
6  "sponsor_mchid" : "1900001109",
7  "activity_name" : "公益企业配捐活动",
8  "activity_remark" : "公益活动开始于9月1日,帮助困难儿童筹款活动",
9  "state" : "PENDING",
10  "confirm_url" : "https://www.weixin.qq.com/wxpay/pay.php",
11  "remain_amount" : 0,
12  "unlock_remark" : "",
13  "locked_time" : "",
14  "finished_time" : "",
15  "closed_time" : "",
16  "unlocked_amount" : 10000,
17  "closed_reason" : "MCH_OVERDUE_UNCONFIRMED"
18}
19

 

错误码

以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

请根据错误提示正确传入参数

400

INVALID_REQUEST

HTTP 请求不符合微信支付 APIv3 接口规则

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

429

RATELIMIT_EXCEEDED

请求接口频率过快

降低频率,稍后重试

400

INVALID_REQUEST

请求不符合业务规则

请参阅 产品介绍、开发指引 和 接口规则

403

NO_AUTH

没有相关权限

请参阅 产品介绍、开发指引

 

元宝AI
反馈
目录
置顶