Skip to content

合单下单-H5支付

使用合单支付接口,用户只输入一次密码,即可完成多个订单的支付。目前最多一次可支持50笔订单进行合单支付。

请求参数类型描述
jsonobject声明请求的JSON数据结构
combine_appidstring合单商户appid
combine_mchidstring合单商户号
combine_out_trade_nostring合单商户订单号
scene_infoobject场景信息
device_idstring商户端设备号
payer_client_ipstring用户终端IP
h5_infoobjectH5场景信息
typestring场景类型
app_namestring应用名称
app_urlstring网站URL
bundle_idstringiOS平台BundleID
package_namestringAndroid平台PackageName
sub_ordersobject[]子单信息
mchidstring子单商户号
attachstring附加数据
amountobject订单金额
total_amountinteger标价金额
currencystring标价币种
out_trade_nostring子单商户订单号
sub_mchidstring二级商户号
goods_tagstring订单优惠标记
descriptionstring商品描述
settle_infoobject结算信息
profit_sharingboolean是否指定分账
subsidy_amountinteger补差金额
sub_appidstring子商户应用ID
time_startstring交易起始时间
time_expirestring交易结束时间
notify_urlstring通知地址
limit_paystring[]no_balance | no_debit | balance_only 枚举值之一
combine_payer_infoobject支付者
openidstring用户标识
sub_openidstring用户子标识
php
$instance->v3->combineTransactions->h5->postAsync([
  'json' => [
    'combine_appid' => 'wxd678efh567hg6787',
    'combine_mchid' => '1900000109',
    'combine_out_trade_no' => 'P20150806125346',
    'scene_info' => [
      'device_id' => 'POS1:1',
      'payer_client_ip' => '14.17.22.32',
      'h5_info' => [
        'type' => 'iOS',
        'app_name' => '王者荣耀',
        'app_url' => 'https://pay.qq.com',
        'bundle_id' => 'com.tencent.wzryiOS',
        'package_name' => 'com.tencent.tmgp.sgame',
      ],
    ],
    'sub_orders' => [[
      'mchid' => '1900000109',
      'attach' => '深圳分店',
      'amount' => [
        'total_amount' => 100,
        'currency' => 'CNY',
      ],
      'out_trade_no' => '20150806125346',
      'sub_mchid' => '1900000109',
      'goods_tag' => 'WXG',
      'description' => '腾讯充值中心-QQ会员充值',
      'settle_info' => [
        'profit_sharing' => true,
        'subsidy_amount' => 10,
      ],
      'sub_appid' => 'wxd678efh567hg6999',
    ],],
    'time_start' => '2019-12-31T15:59:60+08:00',
    'time_expire' => '2019-12-31T15:59:60+08:00',
    'notify_url' => 'https://yourapp.com/notify',
    'limit_pay' => ['string'],
    'combine_payer_info' => [
      'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
      'sub_openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance->chain('v3/combine-transactions/h5')->postAsync([
  'json' => [
    'combine_appid' => 'wxd678efh567hg6787',
    'combine_mchid' => '1900000109',
    'combine_out_trade_no' => 'P20150806125346',
    'scene_info' => [
      'device_id' => 'POS1:1',
      'payer_client_ip' => '14.17.22.32',
      'h5_info' => [
        'type' => 'iOS',
        'app_name' => '王者荣耀',
        'app_url' => 'https://pay.qq.com',
        'bundle_id' => 'com.tencent.wzryiOS',
        'package_name' => 'com.tencent.tmgp.sgame',
      ],
    ],
    'sub_orders' => [[
      'mchid' => '1900000109',
      'attach' => '深圳分店',
      'amount' => [
        'total_amount' => 100,
        'currency' => 'CNY',
      ],
      'out_trade_no' => '20150806125346',
      'sub_mchid' => '1900000109',
      'goods_tag' => 'WXG',
      'description' => '腾讯充值中心-QQ会员充值',
      'settle_info' => [
        'profit_sharing' => true,
        'subsidy_amount' => 10,
      ],
      'sub_appid' => 'wxd678efh567hg6999',
    ],],
    'time_start' => '2019-12-31T15:59:60+08:00',
    'time_expire' => '2019-12-31T15:59:60+08:00',
    'notify_url' => 'https://yourapp.com/notify',
    'limit_pay' => ['string'],
    'combine_payer_info' => [
      'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
      'sub_openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance['v3/combine-transactions/h5']->postAsync([
  'json' => [
    'combine_appid' => 'wxd678efh567hg6787',
    'combine_mchid' => '1900000109',
    'combine_out_trade_no' => 'P20150806125346',
    'scene_info' => [
      'device_id' => 'POS1:1',
      'payer_client_ip' => '14.17.22.32',
      'h5_info' => [
        'type' => 'iOS',
        'app_name' => '王者荣耀',
        'app_url' => 'https://pay.qq.com',
        'bundle_id' => 'com.tencent.wzryiOS',
        'package_name' => 'com.tencent.tmgp.sgame',
      ],
    ],
    'sub_orders' => [[
      'mchid' => '1900000109',
      'attach' => '深圳分店',
      'amount' => [
        'total_amount' => 100,
        'currency' => 'CNY',
      ],
      'out_trade_no' => '20150806125346',
      'sub_mchid' => '1900000109',
      'goods_tag' => 'WXG',
      'description' => '腾讯充值中心-QQ会员充值',
      'settle_info' => [
        'profit_sharing' => true,
        'subsidy_amount' => 10,
      ],
      'sub_appid' => 'wxd678efh567hg6999',
    ],],
    'time_start' => '2019-12-31T15:59:60+08:00',
    'time_expire' => '2019-12-31T15:59:60+08:00',
    'notify_url' => 'https://yourapp.com/notify',
    'limit_pay' => ['string'],
    'combine_payer_info' => [
      'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
      'sub_openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$response = $instance->v3->combineTransactions->h5->post([
  'json' => [
    'combine_appid' => 'wxd678efh567hg6787',
    'combine_mchid' => '1900000109',
    'combine_out_trade_no' => 'P20150806125346',
    'scene_info' => [
      'device_id' => 'POS1:1',
      'payer_client_ip' => '14.17.22.32',
      'h5_info' => [
        'type' => 'iOS',
        'app_name' => '王者荣耀',
        'app_url' => 'https://pay.qq.com',
        'bundle_id' => 'com.tencent.wzryiOS',
        'package_name' => 'com.tencent.tmgp.sgame',
      ],
    ],
    'sub_orders' => [[
      'mchid' => '1900000109',
      'attach' => '深圳分店',
      'amount' => [
        'total_amount' => 100,
        'currency' => 'CNY',
      ],
      'out_trade_no' => '20150806125346',
      'sub_mchid' => '1900000109',
      'goods_tag' => 'WXG',
      'description' => '腾讯充值中心-QQ会员充值',
      'settle_info' => [
        'profit_sharing' => true,
        'subsidy_amount' => 10,
      ],
      'sub_appid' => 'wxd678efh567hg6999',
    ],],
    'time_start' => '2019-12-31T15:59:60+08:00',
    'time_expire' => '2019-12-31T15:59:60+08:00',
    'notify_url' => 'https://yourapp.com/notify',
    'limit_pay' => ['string'],
    'combine_payer_info' => [
      'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
      'sub_openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance->chain('v3/combine-transactions/h5')->post([
  'json' => [
    'combine_appid' => 'wxd678efh567hg6787',
    'combine_mchid' => '1900000109',
    'combine_out_trade_no' => 'P20150806125346',
    'scene_info' => [
      'device_id' => 'POS1:1',
      'payer_client_ip' => '14.17.22.32',
      'h5_info' => [
        'type' => 'iOS',
        'app_name' => '王者荣耀',
        'app_url' => 'https://pay.qq.com',
        'bundle_id' => 'com.tencent.wzryiOS',
        'package_name' => 'com.tencent.tmgp.sgame',
      ],
    ],
    'sub_orders' => [[
      'mchid' => '1900000109',
      'attach' => '深圳分店',
      'amount' => [
        'total_amount' => 100,
        'currency' => 'CNY',
      ],
      'out_trade_no' => '20150806125346',
      'sub_mchid' => '1900000109',
      'goods_tag' => 'WXG',
      'description' => '腾讯充值中心-QQ会员充值',
      'settle_info' => [
        'profit_sharing' => true,
        'subsidy_amount' => 10,
      ],
      'sub_appid' => 'wxd678efh567hg6999',
    ],],
    'time_start' => '2019-12-31T15:59:60+08:00',
    'time_expire' => '2019-12-31T15:59:60+08:00',
    'notify_url' => 'https://yourapp.com/notify',
    'limit_pay' => ['string'],
    'combine_payer_info' => [
      'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
      'sub_openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance['v3/combine-transactions/h5']->post([
  'json' => [
    'combine_appid' => 'wxd678efh567hg6787',
    'combine_mchid' => '1900000109',
    'combine_out_trade_no' => 'P20150806125346',
    'scene_info' => [
      'device_id' => 'POS1:1',
      'payer_client_ip' => '14.17.22.32',
      'h5_info' => [
        'type' => 'iOS',
        'app_name' => '王者荣耀',
        'app_url' => 'https://pay.qq.com',
        'bundle_id' => 'com.tencent.wzryiOS',
        'package_name' => 'com.tencent.tmgp.sgame',
      ],
    ],
    'sub_orders' => [[
      'mchid' => '1900000109',
      'attach' => '深圳分店',
      'amount' => [
        'total_amount' => 100,
        'currency' => 'CNY',
      ],
      'out_trade_no' => '20150806125346',
      'sub_mchid' => '1900000109',
      'goods_tag' => 'WXG',
      'description' => '腾讯充值中心-QQ会员充值',
      'settle_info' => [
        'profit_sharing' => true,
        'subsidy_amount' => 10,
      ],
      'sub_appid' => 'wxd678efh567hg6999',
    ],],
    'time_start' => '2019-12-31T15:59:60+08:00',
    'time_expire' => '2019-12-31T15:59:60+08:00',
    'notify_url' => 'https://yourapp.com/notify',
    'limit_pay' => ['string'],
    'combine_payer_info' => [
      'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
      'sub_openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
返回字典类型描述
h5_urlstring支付跳转链接

参阅 官方文档

Published on the GitHub by TheNorthMemory