合单下单-小程序

Header HTTP头参数

Authorization 必填 string

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

Accept 必填 string

请设置为application/json

Content-Type 必填 string

请设置为application/json

body 包体参数

combine_appid 必填 string(32)

【合单商户Appid】 合单发起方的Appid

combine_mchid 必填 string(32)

【合单商户号】 合单发起方商户号

combine_out_trade_no 必填 string(32)

【合单商户订单号】 合单支付总订单号，最短2个字符，最长32个字符，只能是数字、大小写字母，以及_-|* ，且在同一个商户号下唯一

scene_info 选填 object

【场景信息】 支付场景描述。

属性 device_id 选填 string(16)

【商户端设备号】 终端设备号(门店号或收银设备ID)。

payer_client_ip 必填 string(45)

【用户终端IP】 用户端实际IP，支持IPv4和IPv6两种格式的IP地址。IP获取请参考获取用户IP指引。

sub_orders 必填 array[UnionSubOrder]

【商品单信息】 商品单列表，最多支持商品单条数：50。

属性 mchid 必填 string(32)

【商品单商户号】商品单发起方商户号，与发起方Appid有绑定关系

attach 必填 string(128)

【附加数据】 附加数据，在查询API和支付通知中原样返回，可作为自定义参数使用。

amount 必填 object

【订单金额】 订单金额

属性 total_amount 必填 integer

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

currency 必填 string(8)

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

out_trade_no 必填 string(32)

【商品单商户订单号】 商户系统内部订单号，最短2个字符，最长32个字符，只能是数字、大小写字母_-|* ，且在同一个商户号下唯一。

sub_mchid 选填 string(32)

【特约商户商户号】 特约商户商户号

detail 选填 string(6000)

【优惠功能】 商品详细描述。

description 必填 string(127)

【商品描述】 商品简单描述。需传入应用市场上的APP名字-实际商品名称，例如 天天爱消除-游戏充值

settle_info 选填 object

【结算信息】 结算信息。

属性 profit_sharing 选填 boolean

【是否指定分账】 是否指定分账，枚举值:true：是false：否。

subsidy_amount 选填 integer

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

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

sub_appid 选填 string(32)

【子商户绑定的Appid】 服务商模式下，sub_mchid对应的sub_appid

goods_tag 选填 string(32)

【订单优惠标记】 订单优惠标记，使用代金券或立减优惠功能时需要的参数，说明详见代金券或立减优惠 。

combine_payer_info 必填 object

【支付者】 支付者信息，必须指定用户的openid或sub_openid。

属性 openid 选填 string(128)

【用户标识】 使用合单Appid获取的对应用户Openid。是用户在商户Appid下的唯一标识。

sub_openid 选填 string(128)

【用户子标识】 服务商模式下，使用某个子商户的Appid获取的对应用户Openid，是用户在该子商户Appid下的唯一标识。openid和sub_openid可以选传其中之一，如果选择传sub_openid，则必须传sub_appid。

time_start 选填 string

【支付起始时间】 订单生效时间，按照rfc3339格式，格式为yyyy-MM-DDTHH:mm:ss+TIMEZONE，yyyy-MM-DD表示年月日，T出现在字符串中，表示time元素的开头，HH:mm:ss表示时分秒，TIMEZONE表示时区（+08:00表示东八区时间，领先UTC8小时，即北京时间）如 2018-06-08T10:34:56+08:00 代表，北京时间2018年06月08日10时34分56秒。

time_expire 选填 string

【支付结束时间】

1、定义：支付结束时间是指用户能够完成该笔订单支付的最后时限，并非订单关闭的时间。超过此时间后，用户将无法对该笔订单进行支付。如商户需在超时后关闭订单，请调用合单关闭订单API接口。

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、若未指定支付结束时间，系统默认以下单时间为起始点计算时效；超过 7 天未支付的订单，无法再支付。

4、注意事项：

若当前实际时间已超过订单设置的支付结束时间（time_expire），建议先使用关单接口关闭订单，再使用新的商户订单号重新下单，生成全新订单供用户支付。

支付结束时间不能早于下单时间后1分钟，若设置的支付结束时间早于该时间，系统将自动调整为下单时间后1分钟作为支付结束时间。

传递的支付结束时间需在下单时间的7天以内，如超过7天，微信支付会自动将该时间调整为下单时间后的第7天。

notify_url 选填 string(255)

【通知地址】 接收微信支付异步通知回调地址，通知url必须为直接可访问的url，不能携带参数。必须使用https协议。