合单下单

使用合单支付接口，用户只输入一次密码，即可完成多个订单的支付。目前最多一次可支持10笔订单进行合单支付。用合单下单api在微信支付服务后台生成预支付交易单，返回正确的预支付交易会话标识后再按扫码、JSAPI、APP、H5等不同场景生成交易串调起支付。

🔐

本接口服务已于 2021.09.01 (北京时间)停止开放，新接口见这里这里这里这里，此文档仅做留存参考。

请求参数	类型	描述
xml	object	声明请求的`XML`数据结构
combine_appid	string	合单appid
combine_mch_id	string	合单商户号
device_info	string	设备号
sign_type	string	签名类型 `HMAC-SHA256` 枚举值
combine_out_trade_no	string	合单商户订单号
spbill_create_ip	string	终端IP
time_start	string	交易起始时间
time_expire	string	交易结束时间
notify_url	string	通知地址
trade_type	string	交易类型
product_id	string	商品ID
combine_openid	string	合单用户标识
scene_info	string	场景信息`JSON`格式字符串

device_id	string	商户端设备号
payer_client_ip	string	用户终端IP
h5_info	object	H5场景信息
type	string	场景类型 `iOS` \| `Android` \| `Wap` 枚举值之一
app_name	string	应用名称
app_url	string	网站URL
bundle_id	string	iOS平台BundleID
package_name	string	Android平台PackageName
sub_order_list	string	子单信息`JSON`格式字符串

order_num	number	子订单数
order_list	object[]	子订单信息
appid	string	子单商户appid
mch_id	string	子单商户号
body	string	商品描述
detail	string	商品详情
attach	string	附加数据
out_trade_no	string	子单商户订单号
fee_type	string	标价币种
total_fee	integer	子单金额，单位为分
sub_appid	string	服务商模式下，特约商户的appid
sub_mch_id	string	特约商户商户号，服务商模式必传

php

$instance->v2->pay->combinedorder->postAsync([
  'xml' => [
    'combine_appid'        => 'wx8888888888888888',
    'combine_mch_id'       => '1900000109',
    'device_info'          => '013467007045764',
    'sign_type'            => 'HMAC-SHA256',
    'combine_out_trade_no' => '1217752501201407033233368018',
    'spbill_create_ip'     => '8.8.8.8',
    'time_start'           => '20171225091010',
    'time_expire'          => '20171225091510',
    'notify_url'           => 'http://www.weixin.qq.com/wxpay/pay.php',
    'trade_type'           => 'JSAPI',
    'product_id'           => '1234567890',
    'combine_openid'       => '120061098828009406',
    'scene_info'           => \json_encode([
      'device_id'       => 'POS1:1',
      'payer_client_ip' => '14.17.22.32',
      'h5_info'         => [
        'type'         => 'iOS',
        'app_name'     => '王者荣耀',
        'app_url'      => '',
        'bundle_id'    => 'com.tencent.wzryIOS',
        'package_name' => '',
      ],
    ]),
    'sub_order_list'       => \json_encode([
      'order_num'  => 2,
      'order_list' => [[
        'appid'        => 'wxdace645e0bc2c424',
        'mch_id'       => '1900009001',
        'body'         => '子订单1',
        'detail'       => '商品详细描述',
        'attach'       => '深圳分店',
        'out_trade_no' => 'OD201708030001',
        'fee_type'     => 'CNY',
        'total_fee'    => 88,
        'sub_appid'    => 'wxd678efh567hg6787',
        'sub_mch_id'   => '1256324589',
      ],],
    ]),
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
})
->wait();

php

$instance->chain('v2/pay/combinedorder')->postAsync([
  'xml' => [
    'combine_appid'        => 'wx8888888888888888',
    'combine_mch_id'       => '1900000109',
    'device_info'          => '013467007045764',
    'sign_type'            => 'HMAC-SHA256',
    'combine_out_trade_no' => '1217752501201407033233368018',
    'spbill_create_ip'     => '8.8.8.8',
    'time_start'           => '20171225091010',
    'time_expire'          => '20171225091510',
    'notify_url'           => 'http://www.weixin.qq.com/wxpay/pay.php',
    'trade_type'           => 'JSAPI',
    'product_id'           => '1234567890',
    'combine_openid'       => '120061098828009406',
    'scene_info'           => \json_encode([
      'device_id'       => 'POS1:1',
      'payer_client_ip' => '14.17.22.32',
      'h5_info'         => [
        'type'         => 'iOS',
        'app_name'     => '王者荣耀',
        'app_url'      => '',
        'bundle_id'    => 'com.tencent.wzryIOS',
        'package_name' => '',
      ],
    ]),
    'sub_order_list'       => \json_encode([
      'order_num'  => 2,
      'order_list' => [[
        'appid'        => 'wxdace645e0bc2c424',
        'mch_id'       => '1900009001',
        'body'         => '子订单1',
        'detail'       => '商品详细描述',
        'attach'       => '深圳分店',
        'out_trade_no' => 'OD201708030001',
        'fee_type'     => 'CNY',
        'total_fee'    => 88,
        'sub_appid'    => 'wxd678efh567hg6787',
        'sub_mch_id'   => '1256324589',
      ],],
    ]),
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
})
->wait();

php

$instance['v2/pay/combinedorder']->postAsync([
  'xml' => [
    'combine_appid'        => 'wx8888888888888888',
    'combine_mch_id'       => '1900000109',
    'device_info'          => '013467007045764',
    'sign_type'            => 'HMAC-SHA256',
    'combine_out_trade_no' => '1217752501201407033233368018',
    'spbill_create_ip'     => '8.8.8.8',
    'time_start'           => '20171225091010',
    'time_expire'          => '20171225091510',
    'notify_url'           => 'http://www.weixin.qq.com/wxpay/pay.php',
    'trade_type'           => 'JSAPI',
    'product_id'           => '1234567890',
    'combine_openid'       => '120061098828009406',
    'scene_info'           => \json_encode([
      'device_id'       => 'POS1:1',
      'payer_client_ip' => '14.17.22.32',
      'h5_info'         => [
        'type'         => 'iOS',
        'app_name'     => '王者荣耀',
        'app_url'      => '',
        'bundle_id'    => 'com.tencent.wzryIOS',
        'package_name' => '',
      ],
    ]),
    'sub_order_list'       => \json_encode([
      'order_num'  => 2,
      'order_list' => [[
        'appid'        => 'wxdace645e0bc2c424',
        'mch_id'       => '1900009001',
        'body'         => '子订单1',
        'detail'       => '商品详细描述',
        'attach'       => '深圳分店',
        'out_trade_no' => 'OD201708030001',
        'fee_type'     => 'CNY',
        'total_fee'    => 88,
        'sub_appid'    => 'wxd678efh567hg6787',
        'sub_mch_id'   => '1256324589',
      ],],
    ]),
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
})
->wait();

php

$response = $instance->v2->pay->combinedorder->post([
  'xml' => [
    'combine_appid'        => 'wx8888888888888888',
    'combine_mch_id'       => '1900000109',
    'device_info'          => '013467007045764',
    'sign_type'            => 'HMAC-SHA256',
    'combine_out_trade_no' => '1217752501201407033233368018',
    'spbill_create_ip'     => '8.8.8.8',
    'time_start'           => '20171225091010',
    'time_expire'          => '20171225091510',
    'notify_url'           => 'http://www.weixin.qq.com/wxpay/pay.php',
    'trade_type'           => 'JSAPI',
    'product_id'           => '1234567890',
    'combine_openid'       => '120061098828009406',
    'scene_info'           => \json_encode([
      'device_id'       => 'POS1:1',
      'payer_client_ip' => '14.17.22.32',
      'h5_info'         => [
        'type'         => 'iOS',
        'app_name'     => '王者荣耀',
        'app_url'      => '',
        'bundle_id'    => 'com.tencent.wzryIOS',
        'package_name' => '',
      ],
    ]),
    'sub_order_list'       => \json_encode([
      'order_num'  => 2,
      'order_list' => [[
        'appid'        => 'wxdace645e0bc2c424',
        'mch_id'       => '1900009001',
        'body'         => '子订单1',
        'detail'       => '商品详细描述',
        'attach'       => '深圳分店',
        'out_trade_no' => 'OD201708030001',
        'fee_type'     => 'CNY',
        'total_fee'    => 88,
        'sub_appid'    => 'wxd678efh567hg6787',
        'sub_mch_id'   => '1256324589',
      ],],
    ]),
  ],
]);
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));

php

$response = $instance->chain('v2/pay/combinedorder')->post([
  'xml' => [
    'combine_appid'        => 'wx8888888888888888',
    'combine_mch_id'       => '1900000109',
    'device_info'          => '013467007045764',
    'sign_type'            => 'HMAC-SHA256',
    'combine_out_trade_no' => '1217752501201407033233368018',
    'spbill_create_ip'     => '8.8.8.8',
    'time_start'           => '20171225091010',
    'time_expire'          => '20171225091510',
    'notify_url'           => 'http://www.weixin.qq.com/wxpay/pay.php',
    'trade_type'           => 'JSAPI',
    'product_id'           => '1234567890',
    'combine_openid'       => '120061098828009406',
    'scene_info'           => \json_encode([
      'device_id'       => 'POS1:1',
      'payer_client_ip' => '14.17.22.32',
      'h5_info'         => [
        'type'         => 'iOS',
        'app_name'     => '王者荣耀',
        'app_url'      => '',
        'bundle_id'    => 'com.tencent.wzryIOS',
        'package_name' => '',
      ],
    ]),
    'sub_order_list'       => \json_encode([
      'order_num'  => 2,
      'order_list' => [[
        'appid'        => 'wxdace645e0bc2c424',
        'mch_id'       => '1900009001',
        'body'         => '子订单1',
        'detail'       => '商品详细描述',
        'attach'       => '深圳分店',
        'out_trade_no' => 'OD201708030001',
        'fee_type'     => 'CNY',
        'total_fee'    => 88,
        'sub_appid'    => 'wxd678efh567hg6787',
        'sub_mch_id'   => '1256324589',
      ],],
    ]),
  ],
]);
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));

php

$response = $instance['v2/pay/combinedorder']->post([
  'xml' => [
    'combine_appid'        => 'wx8888888888888888',
    'combine_mch_id'       => '1900000109',
    'device_info'          => '013467007045764',
    'sign_type'            => 'HMAC-SHA256',
    'combine_out_trade_no' => '1217752501201407033233368018',
    'spbill_create_ip'     => '8.8.8.8',
    'time_start'           => '20171225091010',
    'time_expire'          => '20171225091510',
    'notify_url'           => 'http://www.weixin.qq.com/wxpay/pay.php',
    'trade_type'           => 'JSAPI',
    'product_id'           => '1234567890',
    'combine_openid'       => '120061098828009406',
    'scene_info'           => \json_encode([
      'device_id'       => 'POS1:1',
      'payer_client_ip' => '14.17.22.32',
      'h5_info'         => [
        'type'         => 'iOS',
        'app_name'     => '王者荣耀',
        'app_url'      => '',
        'bundle_id'    => 'com.tencent.wzryIOS',
        'package_name' => '',
      ],
    ]),
    'sub_order_list'       => \json_encode([
      'order_num'  => 2,
      'order_list' => [[
        'appid'        => 'wxdace645e0bc2c424',
        'mch_id'       => '1900009001',
        'body'         => '子订单1',
        'detail'       => '商品详细描述',
        'attach'       => '深圳分店',
        'out_trade_no' => 'OD201708030001',
        'fee_type'     => 'CNY',
        'total_fee'    => 88,
        'sub_appid'    => 'wxd678efh567hg6787',
        'sub_mch_id'   => '1256324589',
      ],],
    ]),
  ],
]);
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));

返回字典	类型	描述
return_code	string	返回状态码 `SUCCESS` \| `FAIL` 枚举值之一
return_msg	string	返回信息
combine_appid	string	合单appid
combine_mch_id	string	合单商户号
device_info	string	设备号
nonce_str	string	随机字符串
sign	string	签名
result_code	string	业务结果 `SUCCESS` \| `FAIL` 枚举值之一
err_code	string	错误代码
err_code_des	string	错误代码描述
trade_type	string	交易类型
code_url	string	二维码链接
prepay_id	string	预支付交易会话标识
mweb_url	string	H5支付跳转链接

参阅官方合单支付文档

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

区块链电子发票

自建/三方模式

免确认

免确认

直连商户模式

合作伙伴模式

进件(融合钱包)

基础支付

账单

清关报关

合单下单 ​

合单下单