Skip to content

Native下单

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

请求参数类型描述
jsonobject声明请求的JSON数据结构
appidstring公众号ID
mchidstring直连商户号
descriptionstring商品描述
attachstring附加数据
out_trade_nostring商户订单号
amountobject订单金额
totalinteger总金额
currencystring货币类型
time_expirestring交易结束时间
notify_urlstring通知地址
goods_tagstring订单优惠标记
limit_paystring[]指定支付方式
no_balance | no_credit | no_debit | balance_only 枚举值之一
support_fapiaoboolean电子发票入口开放标识
detailobject优惠功能
cost_priceinteger订单原价
invoice_idstring商品小票ID
goods_detailobject[]单品列表
merchant_goods_idstring商户侧商品编码
wechatpay_goods_idstring微信侧商品编码
goods_namestring商品名称
quantityinteger商品数量
unit_priceinteger商品单价
scene_infoobject场景信息
payer_client_ipstring用户终端IP
device_idstring商户端设备号
store_infoobject商户门店信息
idstring门店编号
namestring门店名称
area_codestring地区编码
addressstring详细地址
php
$instance->v3->pay->transactions->native->postAsync([
  'json' => [
    'appid'          => 'wxd678efh567hg6787',
    'mchid'          => '1230000109',
    'description'    => 'Image形象店-深圳腾大-QQ公仔',
    'attach'         => '自定义数据',
    'out_trade_no'   => '1217752501201407033233368018',
    'amount'         => [
      'total'    => 100,
      'currency' => 'CNY',
    ],
    'time_expire'    => '2018-06-08T10:34:56+08:00',
    'notify_url'     => 'https://www.weixin.qq.com/wxpay/pay.php',
    'goods_tag'      => 'WXG',
    'limit_pay'      => ['string'],
    'support_fapiao' => true,
    'detail'         => [
      'cost_price'   => 608800,
      'invoice_id'   => '微信123',
      'goods_detail' => [[
        'merchant_goods_id'  => '商品编码',
        'wechatpay_goods_id' => '1001',
        'goods_name'         => 'iPhoneX 256G',
        'quantity'           => 1,
        'unit_price'         => 828800,
      ],],
    ],
    'scene_info'     => [
      'payer_client_ip' => '14.23.150.211',
      'device_id'       => '013467007045764',
      'store_info'      => [
        'id'        => '0001',
        'name'      => '腾讯大厦分店',
        'area_code' => '440305',
        'address'   => '广东省深圳市南山区科技中一道10000号',
      ],
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance->chain('v3/pay/transactions/native')->postAsync([
  'json' => [
    'appid'          => 'wxd678efh567hg6787',
    'mchid'          => '1230000109',
    'description'    => 'Image形象店-深圳腾大-QQ公仔',
    'attach'         => '自定义数据',
    'out_trade_no'   => '1217752501201407033233368018',
    'amount'         => [
      'total'    => 100,
      'currency' => 'CNY',
    ],
    'time_expire'    => '2018-06-08T10:34:56+08:00',
    'notify_url'     => 'https://www.weixin.qq.com/wxpay/pay.php',
    'goods_tag'      => 'WXG',
    'limit_pay'      => ['string'],
    'support_fapiao' => true,
    'detail'         => [
      'cost_price'   => 608800,
      'invoice_id'   => '微信123',
      'goods_detail' => [[
        'merchant_goods_id'  => '商品编码',
        'wechatpay_goods_id' => '1001',
        'goods_name'         => 'iPhoneX 256G',
        'quantity'           => 1,
        'unit_price'         => 828800,
      ],],
    ],
    'scene_info'     => [
      'payer_client_ip' => '14.23.150.211',
      'device_id'       => '013467007045764',
      'store_info'      => [
        'id'        => '0001',
        'name'      => '腾讯大厦分店',
        'area_code' => '440305',
        'address'   => '广东省深圳市南山区科技中一道10000号',
      ],
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance['v3/pay/transactions/native']->postAsync([
  'json' => [
    'appid'          => 'wxd678efh567hg6787',
    'mchid'          => '1230000109',
    'description'    => 'Image形象店-深圳腾大-QQ公仔',
    'attach'         => '自定义数据',
    'out_trade_no'   => '1217752501201407033233368018',
    'amount'         => [
      'total'    => 100,
      'currency' => 'CNY',
    ],
    'time_expire'    => '2018-06-08T10:34:56+08:00',
    'notify_url'     => 'https://www.weixin.qq.com/wxpay/pay.php',
    'goods_tag'      => 'WXG',
    'limit_pay'      => ['string'],
    'support_fapiao' => true,
    'detail'         => [
      'cost_price'   => 608800,
      'invoice_id'   => '微信123',
      'goods_detail' => [[
        'merchant_goods_id'  => '商品编码',
        'wechatpay_goods_id' => '1001',
        'goods_name'         => 'iPhoneX 256G',
        'quantity'           => 1,
        'unit_price'         => 828800,
      ],],
    ],
    'scene_info'     => [
      'payer_client_ip' => '14.23.150.211',
      'device_id'       => '013467007045764',
      'store_info'      => [
        'id'        => '0001',
        'name'      => '腾讯大厦分店',
        'area_code' => '440305',
        'address'   => '广东省深圳市南山区科技中一道10000号',
      ],
    ],
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$response = $instance->v3->pay->transactions->native->post([
  'json' => [
    'appid'          => 'wxd678efh567hg6787',
    'mchid'          => '1230000109',
    'description'    => 'Image形象店-深圳腾大-QQ公仔',
    'attach'         => '自定义数据',
    'out_trade_no'   => '1217752501201407033233368018',
    'amount'         => [
      'total'    => 100,
      'currency' => 'CNY',
    ],
    'time_expire'    => '2018-06-08T10:34:56+08:00',
    'notify_url'     => 'https://www.weixin.qq.com/wxpay/pay.php',
    'goods_tag'      => 'WXG',
    'limit_pay'      => ['string'],
    'support_fapiao' => true,
    'detail'         => [
      'cost_price'   => 608800,
      'invoice_id'   => '微信123',
      'goods_detail' => [[
        'merchant_goods_id'  => '商品编码',
        'wechatpay_goods_id' => '1001',
        'goods_name'         => 'iPhoneX 256G',
        'quantity'           => 1,
        'unit_price'         => 828800,
      ],],
    ],
    'scene_info'     => [
      'payer_client_ip' => '14.23.150.211',
      'device_id'       => '013467007045764',
      'store_info'      => [
        'id'        => '0001',
        'name'      => '腾讯大厦分店',
        'area_code' => '440305',
        'address'   => '广东省深圳市南山区科技中一道10000号',
      ],
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance->chain('v3/pay/transactions/native')->post([
  'json' => [
    'appid'          => 'wxd678efh567hg6787',
    'mchid'          => '1230000109',
    'description'    => 'Image形象店-深圳腾大-QQ公仔',
    'attach'         => '自定义数据',
    'out_trade_no'   => '1217752501201407033233368018',
    'amount'         => [
      'total'    => 100,
      'currency' => 'CNY',
    ],
    'time_expire'    => '2018-06-08T10:34:56+08:00',
    'notify_url'     => 'https://www.weixin.qq.com/wxpay/pay.php',
    'goods_tag'      => 'WXG',
    'limit_pay'      => ['string'],
    'support_fapiao' => true,
    'detail'         => [
      'cost_price'   => 608800,
      'invoice_id'   => '微信123',
      'goods_detail' => [[
        'merchant_goods_id'  => '商品编码',
        'wechatpay_goods_id' => '1001',
        'goods_name'         => 'iPhoneX 256G',
        'quantity'           => 1,
        'unit_price'         => 828800,
      ],],
    ],
    'scene_info'     => [
      'payer_client_ip' => '14.23.150.211',
      'device_id'       => '013467007045764',
      'store_info'      => [
        'id'        => '0001',
        'name'      => '腾讯大厦分店',
        'area_code' => '440305',
        'address'   => '广东省深圳市南山区科技中一道10000号',
      ],
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance['v3/pay/transactions/native']->post([
  'json' => [
    'appid'          => 'wxd678efh567hg6787',
    'mchid'          => '1230000109',
    'description'    => 'Image形象店-深圳腾大-QQ公仔',
    'attach'         => '自定义数据',
    'out_trade_no'   => '1217752501201407033233368018',
    'amount'         => [
      'total'    => 100,
      'currency' => 'CNY',
    ],
    'time_expire'    => '2018-06-08T10:34:56+08:00',
    'notify_url'     => 'https://www.weixin.qq.com/wxpay/pay.php',
    'goods_tag'      => 'WXG',
    'limit_pay'      => ['string'],
    'support_fapiao' => true,
    'detail'         => [
      'cost_price'   => 608800,
      'invoice_id'   => '微信123',
      'goods_detail' => [[
        'merchant_goods_id'  => '商品编码',
        'wechatpay_goods_id' => '1001',
        'goods_name'         => 'iPhoneX 256G',
        'quantity'           => 1,
        'unit_price'         => 828800,
      ],],
    ],
    'scene_info'     => [
      'payer_client_ip' => '14.23.150.211',
      'device_id'       => '013467007045764',
      'store_info'      => [
        'id'        => '0001',
        'name'      => '腾讯大厦分店',
        'area_code' => '440305',
        'address'   => '广东省深圳市南山区科技中一道10000号',
      ],
    ],
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
返回字典类型描述
code_urlstring二维码链接

参阅 官方文档

Published on the GitHub by TheNorthMemory