还款下单

更新时间: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

【订单金额】 订单金额。

属性

 total_amount  必填   integer

【标价金额】 商品单金额,单位为分


 currency  必填   string(8)

【标价币种】 符合ISO 4217标准的三位字母代码,人民币:CNY


 attach  必填   string(128)

【商户数据包】 服务商在创建订单时可传入自定义数据包,该数据对用户不可见,用于存储订单相关的服务商自定义信息,其总长度限制在128字符以内,查询API和支付通知中原样返回,并且该字段还会体现在交易账单。


 description  必填   string(127)

【产品描述】 对产品信息的描述,将展示在用户的支付密码确认页、支付凭证、用户账单详情中。服务商需传递能真实代表产品信息的描述,不能超过127个字符。


 settle_info  选填   object

【结算信息】 结算信息。

属性

 profit_sharing  选填   boolean

【是否指定分账】 订单的分账标识在下单时设置,传入true表示在订单支付成功后可进行分账操作。以下是详细说明:

  • 需要分账(传入true):
      订单收款成功后,资金将被冻结并转入子商户基本账户的不可用余额。服务商可通过请求分账API,将收款资金分配给服务商或其他商户及用户。完成分账操作后,可通过接口解冻剩余资金,或在支付成功30天后自动解冻。

  • 不需要分账(传入false或不传,默认为false):
      订单收款成功后,资金不会被冻结,而是直接转入子商户基本账户的可用余额。


 subsidy_amount  选填   integer

【补差金额】 SettleInfo.profit_sharing为true时,该金额才生效。

注意:单笔订单最高补差金额为5000元。


 time_expire  选填   string

【交易结束时间】 1、定义:支付结束时间是指用户能够完成该笔订单支付的最后时限,并非订单关闭的时间。超过此时间后,用户将无法对该笔订单进行支付。如需关闭订单,请调用还款关闭接口。
2、格式要求:支付结束时间需遵循rfc3339标准格式:yyyy-MM-DDTHH:mm:ss+TIMEZONEyyyy-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

【实名支付】 用户的实名信息。

属性

 type  必填   string(32)

【类型】 IDCARD:身份证 HONGKONG_MACAO:港澳回乡证 HONGKONG_MACAO_RESIDENT:港澳居住证 TAIWAN_RESIDENT:台湾居住证 FOREIGN_RESIDENT:外国人永居证 OVERSEA_PASSPORT:护照 TAIWAN_COMPATRIOT_PERMIT:台胞证


 number  必填   string(1024)

【加密后的证件号】 加密后的证件号,该字段需进行加密处理,加密方法详见敏感信息加密说明


 name  必填   string(1024)

【加密后的姓名】 加密后的姓名,该字段需进行加密处理,加密方法详见敏感信息加密说明


 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地址。
IP获取请参考获取用户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】 网页经营场景域名,需为发起微信内网页支付的域名,并在网络经营场景中绑定。

请求示例

curl
Java
Go

POST

1curl -X POST \
2  https://api.mch.weixin.qq.com/v3/repayment/combine-transactions/partner/prepay \
3  -H "Authorization: WECHATPAY2-SHA256-RSA2048 mchid=\"1900000001\",..." \
4  -H "Accept: application/json" \
5  -H "Content-Type: application/json" \
6  -d '{
7    "combine_out_trade_no" : "1217752501201407033233368018",
8    "combine_mchid" : "1230000109",
9    "sub_orders" : [
10      {
11        "mchid" : "1230000109",
12        "sub_mchid" : "1900000109",
13        "out_trade_no" : "20150806125346",
14        "amount" : {
15          "total_amount" : 10,
16          "currency" : "CNY"
17        },
18        "attach" : "深圳分店",
19        "description" : "某某放心借",
20        "settle_info" : {
21          "profit_sharing" : false,
22          "subsidy_amount" : 10
23        }
24      }
25    ],
26    "time_expire" : "2018-06-08T10:34:56+08:00",
27    "notify_url" : "https://yourapp.com/notify",
28    "h5_info" : {
29      "combine_appid" : "wxd678efh567hg6787",
30      "payer_client_ip" : "14.23.150.211",
31      "type" : "iOS",
32      "app_name" : "王者荣耀",
33      "app_url" : "https://pay.qq.com",
34      "bundle_id" : "com.tencent.wzryiOS",
35      "package_name" : "com.tencent.tmgp.sgame"
36    },
37    "app_info" : {
38      "combine_appid" : "wxd678efh567hg6787"
39    },
40    "miniprogram_info" : {
41      "combine_appid" : "wxd678efh567hg6787",
42      "openid" : "oUpF8uMuAJO_M2pxb1Q9zNjWeS6o\t"
43    }
44  }'
45

应答参数

200 OK

 prepay_id  选填   string(64)

【预支付交易会话标识】 微信生成的预支付会话标识,数字和字母组成,用于小程序调起支付app调起支付微信内网页调起支付,该值有效期为2小时。


 h5_url  选填   string(512)

【支付跳转链接】 H5调起支付跳转链接,链接有效期为5分钟,下单时传入H5调起支付信息时返回该字段

应答示例

200 OK

1{
2  "prepay_id" : "wx201410272009395522657a690389285100",
3  "h5_url" : "https://wx.tenpay.com/cgi-bin/mmpayweb-bin/checkmweb?prepay_id=wx2016121516420242444321ca0631331346&package=1405458241"
4}
5

 

错误码

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

状态码

错误码

描述

解决方案

400

PARAM_ERROR

参数错误

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

400

INVALID_REQUEST

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

请参阅 接口规则

401

SIGN_ERROR

验证不通过

请参阅 签名常见问题

500

SYSTEM_ERROR

系统异常,请稍后重试

请稍后重试

 

元宝AI
反馈
目录
置顶