统一下单

除付款码支付场景以外，商户系统先调用该接口在微信支付服务后台生成预支付交易单，返回正确的预支付交易会话标识后再按Native、JSAPI、APP等不同场景生成交易串调起支付。

请求参数	类型	描述
xml	object	声明请求的`XML`数据结构
version	string	接口版本号 `1.0` 枚举值
profit_sharing	string	是否指定服务商分账;Y-是，需要分账;N-否，不分账;字母要求大写，不传默认不分账 `N` \| `Y` 枚举值之一
appid	string	公众账号ID
mch_id	string	商户号
device_info	string	设备号
sign_type	string	签名类型 `MD5` \| `HMAC-SHA256` 枚举值之一
body	string	商品描述
detail	string	单品优惠活动该字段必传，`JSON`格式字符串

cost_price	number	订单原价
receipt_id	string	商品小票ID
goods_detail	object[]	单品列表
goods_id	string	商品编码
wxpay_goods_id	string	微信支付商品编码
goods_name	string	商品名称
quantity	number	商品数量
price	number	商品单价
attach	string	附加数据
out_trade_no	string	商户订单号
fee_type	string	标价币种
total_fee	integer	标价金额
spbill_create_ip	string	终端IP
time_start	string	交易起始时间
time_expire	string	交易结束时间
goods_tag	string	订单优惠标记
notify_url	string	通知地址
trade_type	string	交易类型
product_id	string	商品ID
limit_pay	string	指定支付方式
openid	string	用户标识
receipt	string	电子发票入口开放标识 `Y` \| `N` 枚举值之一
scene_info	string	场景信息`JSON`格式字符串

store_info	object	实际门店信息
id	string	门店id
name	string	门店名称
area_code	string	门店行政区划码
address	string	门店详细地址
user_type	string	证件类型(指定身份支付) `IDCARD` \| `HONGKONG_MACAO` \| `HONGKONG_MACAO_RESIDENT` \| `TAIWAN_RESIDENT` \| `FOREIGN_RESIDENT` \| `OVERSEA_PASSPORT` 枚举值之一
user_creid	string	证件号(指定身份支付)
user_truename	string	姓名(指定身份支付)

php

$instance->v2->pay->unifiedorder->postAsync([
  'xml' => [
    'version'          => '1.0',
    'profit_sharing'   => 'N',
    'appid'            => 'wxd678efh567hg6787',
    'mch_id'           => '1230000109',
    'device_info'      => '013467007045764',
    'sign_type'        => 'MD5',
    'body'             => '腾讯充值中心-QQ会员充值',
    'detail'           => \json_encode([
      'cost_price'   => 1,
      'receipt_id'   => 'wx123',
      'goods_detail' => [[
        'goods_id'       => '商品编码',
        'wxpay_goods_id' => '1001',
        'goods_name'     => 'iPhone6s 16G',
        'quantity'       => 1,
        'price'          => 528800,
      ],],
    ]),
    'attach'           => '深圳分店',
    'out_trade_no'     => '20150806125346',
    'fee_type'         => 'CNY',
    'total_fee'        => '88',
    'spbill_create_ip' => '123.12.12.123',
    'time_start'       => '20091225091010',
    'time_expire'      => '20091227091010',
    'goods_tag'        => 'WXG',
    'notify_url'       => 'http://www.weixin.qq.com/wxpay/pay.php',
    'trade_type'       => 'JSAPI',
    'product_id'       => '12235413214070356458058',
    'limit_pay'        => 'no_credit',
    'openid'           => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    'receipt'          => 'Y',
    'scene_info'       => \json_encode([
      'store_info' => [
        'id'        => 'SZTX001',
        'name'      => '腾大餐厅',
        'area_code' => '440305',
        'address'   => '科技园中一路腾讯大厦',
      ],
    ]),
    'user_type'        => 'IDCARD',
    'user_creid'       => '43102119910910512X',
    'user_truename'    => '周星星',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
})
->wait();

php

$instance->chain('v2/pay/unifiedorder')->postAsync([
  'xml' => [
    'version'          => '1.0',
    'profit_sharing'   => 'N',
    'appid'            => 'wxd678efh567hg6787',
    'mch_id'           => '1230000109',
    'device_info'      => '013467007045764',
    'sign_type'        => 'MD5',
    'body'             => '腾讯充值中心-QQ会员充值',
    'detail'           => \json_encode([
      'cost_price'   => 1,
      'receipt_id'   => 'wx123',
      'goods_detail' => [[
        'goods_id'       => '商品编码',
        'wxpay_goods_id' => '1001',
        'goods_name'     => 'iPhone6s 16G',
        'quantity'       => 1,
        'price'          => 528800,
      ],],
    ]),
    'attach'           => '深圳分店',
    'out_trade_no'     => '20150806125346',
    'fee_type'         => 'CNY',
    'total_fee'        => '88',
    'spbill_create_ip' => '123.12.12.123',
    'time_start'       => '20091225091010',
    'time_expire'      => '20091227091010',
    'goods_tag'        => 'WXG',
    'notify_url'       => 'http://www.weixin.qq.com/wxpay/pay.php',
    'trade_type'       => 'JSAPI',
    'product_id'       => '12235413214070356458058',
    'limit_pay'        => 'no_credit',
    'openid'           => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    'receipt'          => 'Y',
    'scene_info'       => \json_encode([
      'store_info' => [
        'id'        => 'SZTX001',
        'name'      => '腾大餐厅',
        'area_code' => '440305',
        'address'   => '科技园中一路腾讯大厦',
      ],
    ]),
    'user_type'        => 'IDCARD',
    'user_creid'       => '43102119910910512X',
    'user_truename'    => '周星星',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
})
->wait();

php

$instance['v2/pay/unifiedorder']->postAsync([
  'xml' => [
    'version'          => '1.0',
    'profit_sharing'   => 'N',
    'appid'            => 'wxd678efh567hg6787',
    'mch_id'           => '1230000109',
    'device_info'      => '013467007045764',
    'sign_type'        => 'MD5',
    'body'             => '腾讯充值中心-QQ会员充值',
    'detail'           => \json_encode([
      'cost_price'   => 1,
      'receipt_id'   => 'wx123',
      'goods_detail' => [[
        'goods_id'       => '商品编码',
        'wxpay_goods_id' => '1001',
        'goods_name'     => 'iPhone6s 16G',
        'quantity'       => 1,
        'price'          => 528800,
      ],],
    ]),
    'attach'           => '深圳分店',
    'out_trade_no'     => '20150806125346',
    'fee_type'         => 'CNY',
    'total_fee'        => '88',
    'spbill_create_ip' => '123.12.12.123',
    'time_start'       => '20091225091010',
    'time_expire'      => '20091227091010',
    'goods_tag'        => 'WXG',
    'notify_url'       => 'http://www.weixin.qq.com/wxpay/pay.php',
    'trade_type'       => 'JSAPI',
    'product_id'       => '12235413214070356458058',
    'limit_pay'        => 'no_credit',
    'openid'           => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    'receipt'          => 'Y',
    'scene_info'       => \json_encode([
      'store_info' => [
        'id'        => 'SZTX001',
        'name'      => '腾大餐厅',
        'area_code' => '440305',
        'address'   => '科技园中一路腾讯大厦',
      ],
    ]),
    'user_type'        => 'IDCARD',
    'user_creid'       => '43102119910910512X',
    'user_truename'    => '周星星',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
})
->wait();

php

$response = $instance->v2->pay->unifiedorder->post([
  'xml' => [
    'version'          => '1.0',
    'profit_sharing'   => 'N',
    'appid'            => 'wxd678efh567hg6787',
    'mch_id'           => '1230000109',
    'device_info'      => '013467007045764',
    'sign_type'        => 'MD5',
    'body'             => '腾讯充值中心-QQ会员充值',
    'detail'           => \json_encode([
      'cost_price'   => 1,
      'receipt_id'   => 'wx123',
      'goods_detail' => [[
        'goods_id'       => '商品编码',
        'wxpay_goods_id' => '1001',
        'goods_name'     => 'iPhone6s 16G',
        'quantity'       => 1,
        'price'          => 528800,
      ],],
    ]),
    'attach'           => '深圳分店',
    'out_trade_no'     => '20150806125346',
    'fee_type'         => 'CNY',
    'total_fee'        => '88',
    'spbill_create_ip' => '123.12.12.123',
    'time_start'       => '20091225091010',
    'time_expire'      => '20091227091010',
    'goods_tag'        => 'WXG',
    'notify_url'       => 'http://www.weixin.qq.com/wxpay/pay.php',
    'trade_type'       => 'JSAPI',
    'product_id'       => '12235413214070356458058',
    'limit_pay'        => 'no_credit',
    'openid'           => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    'receipt'          => 'Y',
    'scene_info'       => \json_encode([
      'store_info' => [
        'id'        => 'SZTX001',
        'name'      => '腾大餐厅',
        'area_code' => '440305',
        'address'   => '科技园中一路腾讯大厦',
      ],
    ]),
    'user_type'        => 'IDCARD',
    'user_creid'       => '43102119910910512X',
    'user_truename'    => '周星星',
  ],
]);
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));

php

$response = $instance->chain('v2/pay/unifiedorder')->post([
  'xml' => [
    'version'          => '1.0',
    'profit_sharing'   => 'N',
    'appid'            => 'wxd678efh567hg6787',
    'mch_id'           => '1230000109',
    'device_info'      => '013467007045764',
    'sign_type'        => 'MD5',
    'body'             => '腾讯充值中心-QQ会员充值',
    'detail'           => \json_encode([
      'cost_price'   => 1,
      'receipt_id'   => 'wx123',
      'goods_detail' => [[
        'goods_id'       => '商品编码',
        'wxpay_goods_id' => '1001',
        'goods_name'     => 'iPhone6s 16G',
        'quantity'       => 1,
        'price'          => 528800,
      ],],
    ]),
    'attach'           => '深圳分店',
    'out_trade_no'     => '20150806125346',
    'fee_type'         => 'CNY',
    'total_fee'        => '88',
    'spbill_create_ip' => '123.12.12.123',
    'time_start'       => '20091225091010',
    'time_expire'      => '20091227091010',
    'goods_tag'        => 'WXG',
    'notify_url'       => 'http://www.weixin.qq.com/wxpay/pay.php',
    'trade_type'       => 'JSAPI',
    'product_id'       => '12235413214070356458058',
    'limit_pay'        => 'no_credit',
    'openid'           => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    'receipt'          => 'Y',
    'scene_info'       => \json_encode([
      'store_info' => [
        'id'        => 'SZTX001',
        'name'      => '腾大餐厅',
        'area_code' => '440305',
        'address'   => '科技园中一路腾讯大厦',
      ],
    ]),
    'user_type'        => 'IDCARD',
    'user_creid'       => '43102119910910512X',
    'user_truename'    => '周星星',
  ],
]);
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));

php

$response = $instance['v2/pay/unifiedorder']->post([
  'xml' => [
    'version'          => '1.0',
    'profit_sharing'   => 'N',
    'appid'            => 'wxd678efh567hg6787',
    'mch_id'           => '1230000109',
    'device_info'      => '013467007045764',
    'sign_type'        => 'MD5',
    'body'             => '腾讯充值中心-QQ会员充值',
    'detail'           => \json_encode([
      'cost_price'   => 1,
      'receipt_id'   => 'wx123',
      'goods_detail' => [[
        'goods_id'       => '商品编码',
        'wxpay_goods_id' => '1001',
        'goods_name'     => 'iPhone6s 16G',
        'quantity'       => 1,
        'price'          => 528800,
      ],],
    ]),
    'attach'           => '深圳分店',
    'out_trade_no'     => '20150806125346',
    'fee_type'         => 'CNY',
    'total_fee'        => '88',
    'spbill_create_ip' => '123.12.12.123',
    'time_start'       => '20091225091010',
    'time_expire'      => '20091227091010',
    'goods_tag'        => 'WXG',
    'notify_url'       => 'http://www.weixin.qq.com/wxpay/pay.php',
    'trade_type'       => 'JSAPI',
    'product_id'       => '12235413214070356458058',
    'limit_pay'        => 'no_credit',
    'openid'           => 'oUpF8uMuAJO_M2pxb1Q9zNjWeS6o',
    'receipt'          => 'Y',
    'scene_info'       => \json_encode([
      'store_info' => [
        'id'        => 'SZTX001',
        'name'      => '腾大餐厅',
        'area_code' => '440305',
        'address'   => '科技园中一路腾讯大厦',
      ],
    ]),
    'user_type'        => 'IDCARD',
    'user_creid'       => '43102119910910512X',
    'user_truename'    => '周星星',
  ],
]);
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));

返回字典	类型	描述
return_code	string	返回状态码 `SUCCESS` \| `FAIL` 枚举值之一
return_msg	string	返回信息
appid	string	公众账号ID
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	交易类型 `JSAPI` \| `NATIVE` \| `APP` \| `MWEB` 枚举值之一
prepay_id	string	预支付交易会话标识
code_url	string	二维码链接
mweb_url	string	支付跳转链接，mweb_url为拉起微信支付收银台的中间页面，可通过访问该url来拉起微信客户端，完成支付,mweb_url的有效期为5分钟。
promotion_detail	string	营销详情`JSON`格式字符串

promotion_id	string	券ID
name	string	优惠名称
scope	string	优惠范围 `GLOBAL` \| `SINGLE` 枚举值之一
type	string	优惠类型 `COUPON` \| `DISCOUNT` 枚举值之一
amount	string	优惠券面额
activity_id	string	活动ID
wxpay_contribute	string	微信出资
merchant_contribute	string	商户出资
other_contribute	string	其他出资
goods_detail	object[]	单品列表
goods_id	string	商品编码
wxpay_goods_id	string	微信支付商品编码
goods_name	string	商品名称
quantity	number	商品数量
price	number	商品单价

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

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

腾讯数电发票模式

区块链电子发票

自建/三方模式

二级商户授权

即时(需用户确认)模式

预约模式

电子回单

免确认

免确认

直连商户模式

合作伙伴模式