统一下单

除付款码支付场景以外，商户系统先调用该接口在微信支付服务后台生成预支付交易单，返回正确的预支付交易会话标识后再按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	门店详细地址

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'   => '科技园中一路腾讯大厦',
      ],
    ]),
  ],
])
->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'   => '科技园中一路腾讯大厦',
      ],
    ]),
  ],
])
->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'   => '科技园中一路腾讯大厦',
      ],
    ]),
  ],
])
->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'   => '科技园中一路腾讯大厦',
      ],
    ]),
  ],
]);
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'   => '科技园中一路腾讯大厦',
      ],
    ]),
  ],
]);
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'   => '科技园中一路腾讯大厦',
      ],
    ]),
  ],
]);
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	商品单价

参阅官方JSAPI文档 Native官方文档官方APP文档官方H5文档官方小程序支付文档

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

区块链电子发票

自建/三方模式

免确认

免确认

直连商户模式

合作伙伴模式

进件(融合钱包)

基础支付

账单

清关报关

统一下单 ​

统一下单