wechatpay.im

主题模式

合单下单-APP支付 ​

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

请求参数类型描述
jsonobject声明请求的JSON数据结构
combine_appidstring合单商户appid
combine_mchidstring合单商户号
combine_out_trade_nostring合单商户订单号
scene_infoobject场景信息
device_idstring商户端设备号
payer_client_ipstring用户终端IP
sub_ordersobject[]子单信息
mchidstring子单商户号
individual_auth_idstring商品单个人收款方受理授权ID
individual_namestring商品单个人收款方平台昵称
attachstring附加数据
amountobject订单金额
total_amountinteger标价金额
currencystring标价币种
out_trade_nostring子单商户订单号
sub_mchidstring二级商户号
detailstring商品详情
goods_tagstring订单优惠标记
descriptionstring商品描述
settle_infoobject结算信息
profit_sharingboolean是否指定分账
subsidy_amountinteger补差金额
sub_appidstring子商户应用ID
combine_payer_infoobject支付者
openidstring用户标识
identityobject实名支付(需单独申请权限)
typestring证件类型
IDCARD 枚举值
numberstring加密后的证件号
namestring加密后的姓名
time_startstring交易起始时间
time_expirestring交易结束时间
prepay_idstring预支付交易会话标识
notify_urlstring通知地址
trade_scenariostring交易场景
RECOMMERCE 枚举值
limit_paystring[]指定支付方式
no_balance | no_debit | balance_only 枚举值之一
contract_infoobject预签约信息
mchidstring签约商户号
appidstring签约商户AppID
out_contract_codestring签约商户协议号
plan_idnumber委托代扣协议模板ID
contract_display_accountstring用户账户展示名称
notify_urlstring回调通知地址
subsidy_infoobject贴息信息(微信分付)
subsidy_detailobject[]贴息详情列表
subsidy_period_typestring贴息方案类型
DAILY | PERIOD 枚举值之一
subsidy_planobject[]贴息方案列表
subsidy_installment_numinteger贴息期数
3 | 6 | 12 枚举值之一
subsidy_percentinteger贴息比例
0 | 100 枚举值之一
headersobject声明请求的头参数
Wechatpay-Serialstring微信支付公钥ID/平台证书序列号
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',
      'individual_auth_id' => '1900000109',
      'individual_name'    => '哈哈哈小店',
      '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',
      'identity' => [
        'type'   => 'IDCARD',
        'number' => '6B46824C852FA29AAC3DCE6BFD852E27',
        'name'   => '6B46824C852FA29AAC3DCE6BFD852E27',
      ],
    ],
    'time_start'           => '2019-12-31T15:59:60+08:00',
    'time_expire'          => '2019-12-31T15:59:60+08:00',
    'prepay_id'            => 'wx201410272009395522657a690389285100',
    'notify_url'           => 'https://yourapp.com/notify',
    'trade_scenario'       => 'RECOMMERCE',
    'limit_pay'            => ['no_balance'],
    'contract_info'        => [
      'mchid'                    => '1900000109',
      'appid'                    => 'wxd678efh567hg6787',
      'out_contract_code'        => 'wxwtdk20200910100000',
      'plan_id'                  => 12535,
      'contract_display_account' => '微信代扣用户A',
      'notify_url'               => 'https://yourapp.com/notify',
    ],
    'subsidy_info'         => [
      'subsidy_detail' => [[
        'subsidy_period_type' => 'PERIOD',
        'subsidy_plan'        => [[
          'subsidy_installment_num' => 3,
          'subsidy_percent'         => 100,
        ],],
      ],],
    ],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
])
->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',
      'individual_auth_id' => '1900000109',
      'individual_name'    => '哈哈哈小店',
      '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',
      'identity' => [
        'type'   => 'IDCARD',
        'number' => '6B46824C852FA29AAC3DCE6BFD852E27',
        'name'   => '6B46824C852FA29AAC3DCE6BFD852E27',
      ],
    ],
    'time_start'           => '2019-12-31T15:59:60+08:00',
    'time_expire'          => '2019-12-31T15:59:60+08:00',
    'prepay_id'            => 'wx201410272009395522657a690389285100',
    'notify_url'           => 'https://yourapp.com/notify',
    'trade_scenario'       => 'RECOMMERCE',
    'limit_pay'            => ['no_balance'],
    'contract_info'        => [
      'mchid'                    => '1900000109',
      'appid'                    => 'wxd678efh567hg6787',
      'out_contract_code'        => 'wxwtdk20200910100000',
      'plan_id'                  => 12535,
      'contract_display_account' => '微信代扣用户A',
      'notify_url'               => 'https://yourapp.com/notify',
    ],
    'subsidy_info'         => [
      'subsidy_detail' => [[
        'subsidy_period_type' => 'PERIOD',
        'subsidy_plan'        => [[
          'subsidy_installment_num' => 3,
          'subsidy_percent'         => 100,
        ],],
      ],],
    ],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
])
->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',
      'individual_auth_id' => '1900000109',
      'individual_name'    => '哈哈哈小店',
      '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',
      'identity' => [
        'type'   => 'IDCARD',
        'number' => '6B46824C852FA29AAC3DCE6BFD852E27',
        'name'   => '6B46824C852FA29AAC3DCE6BFD852E27',
      ],
    ],
    'time_start'           => '2019-12-31T15:59:60+08:00',
    'time_expire'          => '2019-12-31T15:59:60+08:00',
    'prepay_id'            => 'wx201410272009395522657a690389285100',
    'notify_url'           => 'https://yourapp.com/notify',
    'trade_scenario'       => 'RECOMMERCE',
    'limit_pay'            => ['no_balance'],
    'contract_info'        => [
      'mchid'                    => '1900000109',
      'appid'                    => 'wxd678efh567hg6787',
      'out_contract_code'        => 'wxwtdk20200910100000',
      'plan_id'                  => 12535,
      'contract_display_account' => '微信代扣用户A',
      'notify_url'               => 'https://yourapp.com/notify',
    ],
    'subsidy_info'         => [
      'subsidy_detail' => [[
        'subsidy_period_type' => 'PERIOD',
        'subsidy_plan'        => [[
          'subsidy_installment_num' => 3,
          'subsidy_percent'         => 100,
        ],],
      ],],
    ],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
])
->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',
      'individual_auth_id' => '1900000109',
      'individual_name'    => '哈哈哈小店',
      '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',
      'identity' => [
        'type'   => 'IDCARD',
        'number' => '6B46824C852FA29AAC3DCE6BFD852E27',
        'name'   => '6B46824C852FA29AAC3DCE6BFD852E27',
      ],
    ],
    'time_start'           => '2019-12-31T15:59:60+08:00',
    'time_expire'          => '2019-12-31T15:59:60+08:00',
    'prepay_id'            => 'wx201410272009395522657a690389285100',
    'notify_url'           => 'https://yourapp.com/notify',
    'trade_scenario'       => 'RECOMMERCE',
    'limit_pay'            => ['no_balance'],
    'contract_info'        => [
      'mchid'                    => '1900000109',
      'appid'                    => 'wxd678efh567hg6787',
      'out_contract_code'        => 'wxwtdk20200910100000',
      'plan_id'                  => 12535,
      'contract_display_account' => '微信代扣用户A',
      'notify_url'               => 'https://yourapp.com/notify',
    ],
    'subsidy_info'         => [
      'subsidy_detail' => [[
        'subsidy_period_type' => 'PERIOD',
        'subsidy_plan'        => [[
          'subsidy_installment_num' => 3,
          'subsidy_percent'         => 100,
        ],],
      ],],
    ],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
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',
      'individual_auth_id' => '1900000109',
      'individual_name'    => '哈哈哈小店',
      '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',
      'identity' => [
        'type'   => 'IDCARD',
        'number' => '6B46824C852FA29AAC3DCE6BFD852E27',
        'name'   => '6B46824C852FA29AAC3DCE6BFD852E27',
      ],
    ],
    'time_start'           => '2019-12-31T15:59:60+08:00',
    'time_expire'          => '2019-12-31T15:59:60+08:00',
    'prepay_id'            => 'wx201410272009395522657a690389285100',
    'notify_url'           => 'https://yourapp.com/notify',
    'trade_scenario'       => 'RECOMMERCE',
    'limit_pay'            => ['no_balance'],
    'contract_info'        => [
      'mchid'                    => '1900000109',
      'appid'                    => 'wxd678efh567hg6787',
      'out_contract_code'        => 'wxwtdk20200910100000',
      'plan_id'                  => 12535,
      'contract_display_account' => '微信代扣用户A',
      'notify_url'               => 'https://yourapp.com/notify',
    ],
    'subsidy_info'         => [
      'subsidy_detail' => [[
        'subsidy_period_type' => 'PERIOD',
        'subsidy_plan'        => [[
          'subsidy_installment_num' => 3,
          'subsidy_percent'         => 100,
        ],],
      ],],
    ],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
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',
      'individual_auth_id' => '1900000109',
      'individual_name'    => '哈哈哈小店',
      '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',
      'identity' => [
        'type'   => 'IDCARD',
        'number' => '6B46824C852FA29AAC3DCE6BFD852E27',
        'name'   => '6B46824C852FA29AAC3DCE6BFD852E27',
      ],
    ],
    'time_start'           => '2019-12-31T15:59:60+08:00',
    'time_expire'          => '2019-12-31T15:59:60+08:00',
    'prepay_id'            => 'wx201410272009395522657a690389285100',
    'notify_url'           => 'https://yourapp.com/notify',
    'trade_scenario'       => 'RECOMMERCE',
    'limit_pay'            => ['no_balance'],
    'contract_info'        => [
      'mchid'                    => '1900000109',
      'appid'                    => 'wxd678efh567hg6787',
      'out_contract_code'        => 'wxwtdk20200910100000',
      'plan_id'                  => 12535,
      'contract_display_account' => '微信代扣用户A',
      'notify_url'               => 'https://yourapp.com/notify',
    ],
    'subsidy_info'         => [
      'subsidy_detail' => [[
        'subsidy_period_type' => 'PERIOD',
        'subsidy_plan'        => [[
          'subsidy_installment_num' => 3,
          'subsidy_percent'         => 100,
        ],],
      ],],
    ],
  ],
  'headers' => [
    'Wechatpay-Serial' => 'PUB_KEY_ID_0114232134912410000000000000',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
返回字典类型描述
prepay_idstring预支付交易会话标识
contract_resultobject预签约结果
codestring签约结果码
messagestring签约结果描述信息

参阅 官方文档 官方文档 官方文档 官方文档 官方文档 官方文档 官方文档

Published on the GitHub by TheNorthMemory