合单下单-APP支付

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

请求参数	类型	描述
json	object	声明请求的`JSON`数据结构
combine_appid	string	合单商户appid
combine_mchid	string	合单商户号
combine_out_trade_no	string	合单商户订单号
scene_info	object	场景信息
device_id	string	商户端设备号
payer_client_ip	string	用户终端IP
sub_orders	object[]	子单信息
mchid	string	子单商户号
attach	string	附加数据
amount	object	订单金额
total_amount	integer	标价金额
currency	string	标价币种
out_trade_no	string	子单商户订单号
sub_mchid	string	二级商户号
detail	string	商品详情
goods_tag	string	订单优惠标记
description	string	商品描述
settle_info	object	结算信息
profit_sharing	boolean	是否指定分账
subsidy_amount	integer	补差金额
sub_appid	string	子商户应用ID
combine_payer_info	object	支付者
openid	string	用户标识
time_start	string	交易起始时间
time_expire	string	交易结束时间
notify_url	string	通知地址
limit_pay	string[]	`no_balance` \| `no_debit` \| `balance_only` 枚举值之一
contract_info	object	预签约信息
mchid	string	签约商户号
appid	string	签约商户AppID
out_contract_code	string	签约商户协议号
plan_id	number	委托代扣协议模板ID
contract_display_account	string	用户账户展示名称
notify_url	string	回调通知地址

php

$instance->v3->combineTransactions->app->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',
    ],
    'sub_orders' => [[
      'mchid' => '1900000109',
      'attach' => '深圳分店',
      'amount' => [
        'total_amount' => 100,
        'currency' => 'CNY',
      ],
      'out_trade_no' => '20150806125346',
      'sub_mchid' => '1900000109',
      'detail' => '买单费用',
      'goods_tag' => 'WXG',
      'description' => '腾讯充值中心-QQ会员充值',
      'settle_info' => [
        'profit_sharing' => true,
        'subsidy_amount' => 10,
      ],
      'sub_appid' => 'wxd678efh567hg6999',
    ],],
    'combine_payer_info' => [
      'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    ],
    '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'],
    'contract_info' => [
      'mchid' => '1900000109',
      'appid' => 'wxd678efh567hg6787',
      'out_contract_code' => 'wxwtdk20200910100000',
      'plan_id' => 12535,
      'contract_display_account' => '微信代扣用户A',
      'notify_url' => 'https://yourapp.com/notify',
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance->chain('v3/combine-transactions/app')->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',
    ],
    'sub_orders' => [[
      'mchid' => '1900000109',
      'attach' => '深圳分店',
      'amount' => [
        'total_amount' => 100,
        'currency' => 'CNY',
      ],
      'out_trade_no' => '20150806125346',
      'sub_mchid' => '1900000109',
      'detail' => '买单费用',
      'goods_tag' => 'WXG',
      'description' => '腾讯充值中心-QQ会员充值',
      'settle_info' => [
        'profit_sharing' => true,
        'subsidy_amount' => 10,
      ],
      'sub_appid' => 'wxd678efh567hg6999',
    ],],
    'combine_payer_info' => [
      'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    ],
    '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'],
    'contract_info' => [
      'mchid' => '1900000109',
      'appid' => 'wxd678efh567hg6787',
      'out_contract_code' => 'wxwtdk20200910100000',
      'plan_id' => 12535,
      'contract_display_account' => '微信代扣用户A',
      'notify_url' => 'https://yourapp.com/notify',
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$instance['v3/combine-transactions/app']->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',
    ],
    'sub_orders' => [[
      'mchid' => '1900000109',
      'attach' => '深圳分店',
      'amount' => [
        'total_amount' => 100,
        'currency' => 'CNY',
      ],
      'out_trade_no' => '20150806125346',
      'sub_mchid' => '1900000109',
      'detail' => '买单费用',
      'goods_tag' => 'WXG',
      'description' => '腾讯充值中心-QQ会员充值',
      'settle_info' => [
        'profit_sharing' => true,
        'subsidy_amount' => 10,
      ],
      'sub_appid' => 'wxd678efh567hg6999',
    ],],
    'combine_payer_info' => [
      'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    ],
    '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'],
    'contract_info' => [
      'mchid' => '1900000109',
      'appid' => 'wxd678efh567hg6787',
      'out_contract_code' => 'wxwtdk20200910100000',
      'plan_id' => 12535,
      'contract_display_account' => '微信代扣用户A',
      'notify_url' => 'https://yourapp.com/notify',
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();

php

$response = $instance->v3->combineTransactions->app->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',
    ],
    'sub_orders' => [[
      'mchid' => '1900000109',
      'attach' => '深圳分店',
      'amount' => [
        'total_amount' => 100,
        'currency' => 'CNY',
      ],
      'out_trade_no' => '20150806125346',
      'sub_mchid' => '1900000109',
      'detail' => '买单费用',
      'goods_tag' => 'WXG',
      'description' => '腾讯充值中心-QQ会员充值',
      'settle_info' => [
        'profit_sharing' => true,
        'subsidy_amount' => 10,
      ],
      'sub_appid' => 'wxd678efh567hg6999',
    ],],
    'combine_payer_info' => [
      'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    ],
    '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'],
    'contract_info' => [
      'mchid' => '1900000109',
      'appid' => 'wxd678efh567hg6787',
      'out_contract_code' => 'wxwtdk20200910100000',
      'plan_id' => 12535,
      'contract_display_account' => '微信代扣用户A',
      'notify_url' => 'https://yourapp.com/notify',
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance->chain('v3/combine-transactions/app')->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',
    ],
    'sub_orders' => [[
      'mchid' => '1900000109',
      'attach' => '深圳分店',
      'amount' => [
        'total_amount' => 100,
        'currency' => 'CNY',
      ],
      'out_trade_no' => '20150806125346',
      'sub_mchid' => '1900000109',
      'detail' => '买单费用',
      'goods_tag' => 'WXG',
      'description' => '腾讯充值中心-QQ会员充值',
      'settle_info' => [
        'profit_sharing' => true,
        'subsidy_amount' => 10,
      ],
      'sub_appid' => 'wxd678efh567hg6999',
    ],],
    'combine_payer_info' => [
      'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    ],
    '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'],
    'contract_info' => [
      'mchid' => '1900000109',
      'appid' => 'wxd678efh567hg6787',
      'out_contract_code' => 'wxwtdk20200910100000',
      'plan_id' => 12535,
      'contract_display_account' => '微信代扣用户A',
      'notify_url' => 'https://yourapp.com/notify',
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

php

$response = $instance['v3/combine-transactions/app']->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',
    ],
    'sub_orders' => [[
      'mchid' => '1900000109',
      'attach' => '深圳分店',
      'amount' => [
        'total_amount' => 100,
        'currency' => 'CNY',
      ],
      'out_trade_no' => '20150806125346',
      'sub_mchid' => '1900000109',
      'detail' => '买单费用',
      'goods_tag' => 'WXG',
      'description' => '腾讯充值中心-QQ会员充值',
      'settle_info' => [
        'profit_sharing' => true,
        'subsidy_amount' => 10,
      ],
      'sub_appid' => 'wxd678efh567hg6999',
    ],],
    'combine_payer_info' => [
      'openid' => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    ],
    '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'],
    'contract_info' => [
      'mchid' => '1900000109',
      'appid' => 'wxd678efh567hg6787',
      'out_contract_code' => 'wxwtdk20200910100000',
      'plan_id' => 12535,
      'contract_display_account' => '微信代扣用户A',
      'notify_url' => 'https://yourapp.com/notify',
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));

返回字典	类型	描述
prepay_id	string	预支付交易会话标识
contract_result	object	预签约结果
code	string	签约结果码
message	string	签约结果描述信息

参阅官方文档

直连商户模式

合作伙伴模式

区块链电子发票

自建/三方模式

免确认

免确认

直连商户模式

合作伙伴模式

可用版本

可用版本

可用版本

合单下单-APP支付 ​

合单下单-APP支付