还款下单
更新时间:2025.05.29接口说明
支持商户:【平台商户】
请求方式:【POST】/v3/repayment/combine-transactions/partner/prepay
请求域名:【主域名】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
Wechatpay-Serial 必填 string
【微信支付公钥ID】或【微信支付平台证书序列号】 请求参数中的敏感字段,需要使用微信支付公钥加密(推荐),请参考获取微信支付公钥ID说明以及微信支付公钥加密敏感信息指引;也可以使用微信支付平台证书公钥加密,参考获取平台证书序列号、平台证书加密敏感信息指引
body 包体参数
combine_out_trade_no 必填 string(32)
【还款单订单号】 商户系统内部对还款单订单定义的订单号,最短2个字符,最长32个字符,只能是数字、大小写字母,以及_-|* ,且在同一个商户号下唯一
combine_mchid 必填 string(32)
【还款服务商商户号】 还款发起方商户号,是由微信支付系统生成并分配给每个服务商的唯一标识符,具体请参考服务商模式开发必要参数说明。
sub_orders 必填 array[object]
【还款明细单信息列表】 还款明细单信息,最多支持还款单条数:10
| 属性 | |||||||||
mchid 必填 string(32) 【还款单发起商户号 】 此处请填写服务商(还款发起方)的商户号combine_mchid sub_mchid 必填 string(32) 【子商户号(也叫特约商户号)】 商品单参与方,由服务商为子商户进件后获取,具体请参考服务商模式开发必要参数说明。 out_trade_no 必填 string(32) 【还款明细单订单号】 商户系统内部对还款明细单定义的订单号,要求32个字符内,只能是数字、大小写字母_-|* ,且在同一个商户号下唯一。 amount 必填 object 【订单金额】 订单金额。
attach 必填 string(128) 【商户数据包】 服务商在创建订单时可传入自定义数据包,该数据对用户不可见,用于存储订单相关的服务商自定义信息,其总长度限制在128字符以内,查询API和支付通知中原样返回,并且该字段还会体现在交易账单。 description 必填 string(127) 【产品描述】 对产品信息的描述,将展示在用户的支付密码确认页、支付凭证、用户账单详情中。服务商需传递能真实代表产品信息的描述,不能超过127个字符。 settle_info 选填 object 【结算信息】 结算信息。
|
time_expire 选填 string
【交易结束时间】 1、定义:支付结束时间是指用户能够完成该笔订单支付的最后时限,并非订单关闭的时间。超过此时间后,用户将无法对该笔订单进行支付。如需关闭订单,请调用还款关闭接口。
2、格式要求:支付结束时间需遵循rfc3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONE。yyyy-MM-DD 表示年月日;T 字符用于分隔日期和时间部分;HH:mm:ss 表示具体的时分秒;TIMEZONE 表示时区(例如,+08:00 对应东八区时间,即北京时间)。
示例:2015-05-20T13:29:35+08:00 表示北京时间2015年5月20日13点29分35秒。
3、注意事项:
time_expire参数仅在用户首次下单时可设置,且不允许后续修改,尝试修改将导致错误。若用户实际进行支付的时间超过了订单设置的支付结束时间,服务商需使用新的商户订单号下单,生成新的订单供用户进行支付。若未超过支付结束时间,则可使用原参数重新请求下单接口,以获取当前订单最新的
prepay_id进行支付。支付结束时间不能早于下单时间后1分钟,若设置的支付结束时间早于该时间,系统将自动调整为下单时间后1分钟作为支付结束时间。
notify_url 选填 string(255)
【通知地址】 服务商接收还款支付成功回调通知的地址,需按照notify_url填写注意事项规范填写。
combine_payer_info 选填 object
【支付者】 支付者信息,可以指定用户的实名信息。
| 属性 | |||||
identity 选填 object 【实名支付】 用户的实名信息。
|
h5_info 选填 object
【H5调起支付场景信息】 还款支付调起微信支付收银台的场景信息,miniprogram_info,app_info,h5_info,wechat_web_info至少需传入一个,支付过程中将检查场景信息是否正确。
| 属性 | |
combine_appid 必填 string(32) 【还款服务商APPID】 服务商(还款发起方)的APPID。APPID是微信开放平台(移动应用)或微信公众平台(小程序、公众号)为开发者的应用程序提供的唯一标识。此处可以填写这三种类型中的任意一种APPID,并确保该combine_appid与combine_mchid有绑定关系。详见:商户号绑定APPID操作说明。 payer_client_ip 必填 string(45) 【用户终端IP】 用户端实际IP,支持IPv4和IPv6两种格式的IP地址。 type 必填 string(32) 【场景类型】 场景类型,使用H5还款的场景:Wap、iOS、Android、Harmony app_name 选填 string(64) 【应用名称】 应用名称 app_url 必填 string(128) 【网站URL】 网站URL bundle_id 选填 string(128) 【iOS平台BundleID】 iOS平台BundleID package_name 选填 string(128) 【Android平台PackageName】 Android平台PackageName |
app_info 选填 object
【APP调起支付场景信息】 还款支付调起微信支付收银台的场景信息,miniprogram_info,app_info,h5_info,wechat_web_info至少需传入一个,支付过程中将检查场景信息是否正确。
| 属性 | |
combine_appid 必填 string(32) 【还款服务商APPID】 服务商(还款发起方)的APPID。APPID是微信开放平台(移动应用)或微信公众平台(小程序、公众号)为开发者的应用程序提供的唯一标识。此处请填写移动应用类型的APPID,并确保该combine_appid与combine_mchid有绑定关系。详见:商户号绑定APPID操作说明。 |
miniprogram_info 选填 object
【小程序调起支付场景信息】 还款支付调起微信支付收银台的场景信息,miniprogram_info,app_info,h5_info,wechat_web_info至少需传入一个,支付过程中将检查场景信息是否正确。
| 属性 | |
combine_appid 必填 string(32) 【还款服务商APPID】 服务商(还款发起方)的APPID。APPID是微信开放平台(移动应用)或微信公众平台(小程序、公众号)为开发者的应用程序提供的唯一标识。此处请填写小程序类型的APPID,并确保该combine_appid与combine_mchid有绑定关系。详见:商户号绑定APPID操作说明。 openid 必填 string(128) 【用户标识】 用户在还款服务商商户号绑定的combine_appid下的唯一标识,获取方式详见 获取OpenID文档。 |
wechat_web_info 选填 object
【微信内网页调起支付场景信息】 还款支付调起微信支付收银台的场景信息,miniprogram_info,app_info,h5_info,wechat_web_info至少需传入一个,支付过程中将检查场景信息是否正确。
| 属性 | |
combine_appid 必填 string(32) 【还款服务商APPID】 服务商(还款发起方)的APPID。APPID是微信开放平台(移动应用)或微信公众平台(小程序、公众号)为开发者的应用程序提供的唯一标识。此处请填写小程序类型的APPID,并确保该combine_appid与combine_mchid有绑定关系。详见:商户号绑定APPID操作说明。 openid 必填 string(128) 【用户标识】 用户在还款服务商商户号绑定的combine_appid下的唯一标识,获取方式详见 获取OpenID文档。 webview_url 必填 string(128) 【网页经营场景URL】 网页经营场景域名,需为发起微信内网页支付的域名,并在网络经营场景中绑定。 |
请求示例
POST
应答参数
200 OK
prepay_id 选填 string(64)
【预支付交易会话标识】 微信生成的预支付会话标识,数字和字母组成,用于小程序调起支付、app调起支付、微信内网页调起支付,该值有效期为2小时。
h5_url 选填 string(512)
【支付跳转链接】 H5调起支付跳转链接,链接有效期为5分钟,下单时传入H5调起支付信息时返回该字段
应答示例
200 OK
错误码
以下是本接口返回的错误码列表。详细错误码规则,请参考微信支付接口规则-错误码和错误提示

