wechatpay.im

主题模式

统一下单 ​

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

请求参数类型描述
xmlobject声明请求的XML数据结构
versionstring接口版本号
profit_sharingstring是否指定服务商分账;Y-是，需要分账;N-否，不分账;字母要求大写，不传默认不分账
N | Y 枚举值之一
appidstring公众账号ID
mch_idstring商户号
device_infostring设备号
sign_typestring签名类型
bodystring商品描述
detailstring单品优惠活动该字段必传，且必须按照规范上传，JSON格式
attachstring附加数据
out_trade_nostring商户订单号
fee_typestring标价币种
total_feeinteger标价金额
spbill_create_ipstring终端IP
time_startstring交易起始时间
time_expirestring交易结束时间
goods_tagstring订单优惠标记
notify_urlstring通知地址
trade_typestring交易类型
product_idstring商品ID
limit_paystring指定支付方式
openidstring用户标识
receiptstring电子发票入口开放标识
scene_infostring+场景信息
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' => '{"cost_price":1,"receipt_id":"wx123","goods_detail":[{"goods_id":"商品编码","wxpay_goods_id":"1001","goods_name":"iPhone6s 16G","quantity":1,"price":1},{"goods_id":"商品编码","wxpay_goods_id":"1002","goods_name":"iPhone6s 32G","quantity":1,"price":1}]}',
    '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' => '{"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' => '{"cost_price":1,"receipt_id":"wx123","goods_detail":[{"goods_id":"商品编码","wxpay_goods_id":"1001","goods_name":"iPhone6s 16G","quantity":1,"price":1},{"goods_id":"商品编码","wxpay_goods_id":"1002","goods_name":"iPhone6s 32G","quantity":1,"price":1}]}',
    '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' => '{"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' => '{"cost_price":1,"receipt_id":"wx123","goods_detail":[{"goods_id":"商品编码","wxpay_goods_id":"1001","goods_name":"iPhone6s 16G","quantity":1,"price":1},{"goods_id":"商品编码","wxpay_goods_id":"1002","goods_name":"iPhone6s 32G","quantity":1,"price":1}]}',
    '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' => '{"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' => '{"cost_price":1,"receipt_id":"wx123","goods_detail":[{"goods_id":"商品编码","wxpay_goods_id":"1001","goods_name":"iPhone6s 16G","quantity":1,"price":1},{"goods_id":"商品编码","wxpay_goods_id":"1002","goods_name":"iPhone6s 32G","quantity":1,"price":1}]}',
    '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' => '{"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' => '{"cost_price":1,"receipt_id":"wx123","goods_detail":[{"goods_id":"商品编码","wxpay_goods_id":"1001","goods_name":"iPhone6s 16G","quantity":1,"price":1},{"goods_id":"商品编码","wxpay_goods_id":"1002","goods_name":"iPhone6s 32G","quantity":1,"price":1}]}',
    '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' => '{"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' => '{"cost_price":1,"receipt_id":"wx123","goods_detail":[{"goods_id":"商品编码","wxpay_goods_id":"1001","goods_name":"iPhone6s 16G","quantity":1,"price":1},{"goods_id":"商品编码","wxpay_goods_id":"1002","goods_name":"iPhone6s 32G","quantity":1,"price":1}]}',
    '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' => '{"store_info" : {"id": "SZTX001","name": "腾大餐厅","area_code": "440305","address": "科技园中一路腾讯大厦" }}',
  ],
]);
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
返回字典类型描述
return_codestring返回状态码
return_msgstring返回信息
appidstring公众账号ID
mch_idstring商户号
device_infostring设备号
nonce_strstring随机字符串
signstring签名
result_codestring业务结果
err_codestring错误代码
err_code_desstring错误代码描述
trade_typestring交易类型
JSAPI | NATIVE | APP | MWEB 枚举值之一
prepay_idstring预支付交易会话标识
code_urlstring二维码链接
mweb_urlstring支付跳转链接，mweb_url为拉起微信支付收银台的中间页面，可通过访问该url来拉起微信客户端，完成支付,mweb_url的有效期为5分钟。
promotion_detailstring营销详情

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

Published on the GitHub by TheNorthMemory