支付押金（付款码支付）

商户通过支付押金（付款码）接口发起押金支付请求；用户使用微信支付完成押金支付，支付完成后扣除相应金额，并生成押金交易记录，下发押金支付凭证；支付成功后，为用户下发押金支付凭证；注意：当押金超过一个月未进行处理，会自动执行退款。

请求参数	类型	描述
xml	object	声明请求的`XML`数据结构
version	string	接口版本号
profit_sharing	string	是否指定服务商分账;Y-是，需要分账;N-否，不分账;字母要求大写，不传默认不分账 `N` \| `Y` 枚举值之一
deposit	string	是否押金支付 `Y` \| `N` 枚举值之一
appid	string	公众账号ID
sub_appid	string	子商户公众账号ID
mch_id	string	商户号
sub_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	商户订单号
total_fee	integer	订单金额
fee_type	string	货币类型
spbill_create_ip	string	终端IP
goods_tag	string	订单优惠标记
limit_pay	string	指定支付方式
time_start	string	交易起始时间
time_expire	string	交易结束时间
receipt	string	电子发票入口开放标识
auth_code	string	授权码
scene_info	string	场景信息`JSON`格式字符串

store_info	object	实际门店信息
id	string	门店id
name	string	门店名称
area_code	string	门店行政区划码
address	string	门店详细地址

php

$instance->v2->deposit->micropay->postAsync([
  'xml' => [
    'version'          => '1.0',
    'profit_sharing'   => 'N',
    'deposit'          => 'Y',
    'appid'            => 'wx8888888888888888',
    'sub_appid'        => 'wx8888888888888888',
    'mch_id'           => '1900000109',
    'sub_mch_id'       => '1900000100',
    'device_info'      => '013467007045764',
    'sign_type'        => 'HMAC-SHA256',
    'body'             => 'image形象店-深圳腾大- 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'     => '1217752501201407033233368018',
    'total_fee'        => '888',
    'fee_type'         => 'CNY',
    'spbill_create_ip' => '8.8.8.8',
    'goods_tag'        => '1234',
    'limit_pay'        => 'no_credit',
    'time_start'       => '20091225091010',
    'time_expire'      => '20091227091010',
    'receipt'          => 'Y',
    'auth_code'        => '120061098828009406',
    '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/deposit/micropay')->postAsync([
  'xml' => [
    'version'          => '1.0',
    'profit_sharing'   => 'N',
    'deposit'          => 'Y',
    'appid'            => 'wx8888888888888888',
    'sub_appid'        => 'wx8888888888888888',
    'mch_id'           => '1900000109',
    'sub_mch_id'       => '1900000100',
    'device_info'      => '013467007045764',
    'sign_type'        => 'HMAC-SHA256',
    'body'             => 'image形象店-深圳腾大- 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'     => '1217752501201407033233368018',
    'total_fee'        => '888',
    'fee_type'         => 'CNY',
    'spbill_create_ip' => '8.8.8.8',
    'goods_tag'        => '1234',
    'limit_pay'        => 'no_credit',
    'time_start'       => '20091225091010',
    'time_expire'      => '20091227091010',
    'receipt'          => 'Y',
    'auth_code'        => '120061098828009406',
    '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/deposit/micropay']->postAsync([
  'xml' => [
    'version'          => '1.0',
    'profit_sharing'   => 'N',
    'deposit'          => 'Y',
    'appid'            => 'wx8888888888888888',
    'sub_appid'        => 'wx8888888888888888',
    'mch_id'           => '1900000109',
    'sub_mch_id'       => '1900000100',
    'device_info'      => '013467007045764',
    'sign_type'        => 'HMAC-SHA256',
    'body'             => 'image形象店-深圳腾大- 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'     => '1217752501201407033233368018',
    'total_fee'        => '888',
    'fee_type'         => 'CNY',
    'spbill_create_ip' => '8.8.8.8',
    'goods_tag'        => '1234',
    'limit_pay'        => 'no_credit',
    'time_start'       => '20091225091010',
    'time_expire'      => '20091227091010',
    'receipt'          => 'Y',
    'auth_code'        => '120061098828009406',
    '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->deposit->micropay->post([
  'xml' => [
    'version'          => '1.0',
    'profit_sharing'   => 'N',
    'deposit'          => 'Y',
    'appid'            => 'wx8888888888888888',
    'sub_appid'        => 'wx8888888888888888',
    'mch_id'           => '1900000109',
    'sub_mch_id'       => '1900000100',
    'device_info'      => '013467007045764',
    'sign_type'        => 'HMAC-SHA256',
    'body'             => 'image形象店-深圳腾大- 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'     => '1217752501201407033233368018',
    'total_fee'        => '888',
    'fee_type'         => 'CNY',
    'spbill_create_ip' => '8.8.8.8',
    'goods_tag'        => '1234',
    'limit_pay'        => 'no_credit',
    'time_start'       => '20091225091010',
    'time_expire'      => '20091227091010',
    'receipt'          => 'Y',
    'auth_code'        => '120061098828009406',
    '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/deposit/micropay')->post([
  'xml' => [
    'version'          => '1.0',
    'profit_sharing'   => 'N',
    'deposit'          => 'Y',
    'appid'            => 'wx8888888888888888',
    'sub_appid'        => 'wx8888888888888888',
    'mch_id'           => '1900000109',
    'sub_mch_id'       => '1900000100',
    'device_info'      => '013467007045764',
    'sign_type'        => 'HMAC-SHA256',
    'body'             => 'image形象店-深圳腾大- 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'     => '1217752501201407033233368018',
    'total_fee'        => '888',
    'fee_type'         => 'CNY',
    'spbill_create_ip' => '8.8.8.8',
    'goods_tag'        => '1234',
    'limit_pay'        => 'no_credit',
    'time_start'       => '20091225091010',
    'time_expire'      => '20091227091010',
    'receipt'          => 'Y',
    'auth_code'        => '120061098828009406',
    '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/deposit/micropay']->post([
  'xml' => [
    'version'          => '1.0',
    'profit_sharing'   => 'N',
    'deposit'          => 'Y',
    'appid'            => 'wx8888888888888888',
    'sub_appid'        => 'wx8888888888888888',
    'mch_id'           => '1900000109',
    'sub_mch_id'       => '1900000100',
    'device_info'      => '013467007045764',
    'sign_type'        => 'HMAC-SHA256',
    'body'             => 'image形象店-深圳腾大- 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'     => '1217752501201407033233368018',
    'total_fee'        => '888',
    'fee_type'         => 'CNY',
    'spbill_create_ip' => '8.8.8.8',
    'goods_tag'        => '1234',
    'limit_pay'        => 'no_credit',
    'time_start'       => '20091225091010',
    'time_expire'      => '20091227091010',
    'receipt'          => 'Y',
    'auth_code'        => '120061098828009406',
    '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
sub_appid	string	子商户公众账号ID
mch_id	string	商户号
sub_mch_id	string	子商户号
device_info	string	设备号
nonce_str	string	随机字符串
sign	string	签名
result_code	string	业务结果 `SUCCESS` \| `FAIL` 枚举值之一
err_code	string	错误代码
err_code_des	string	错误代码描述
openid	string	用户标识
is_subscribe	string	是否关注公众账号 `Y` \| `N` 枚举值之一
trade_type	string	交易类型
bank_type	string	付款银行
fee_type	string	货币类型
total_fee	integer	订单金额
settlement_total_fee	integer	应结订单金额
coupon_fee	integer	代金券金额
cash_fee_type	string	现金支付货币类型
cash_fee	integer	现金支付金额
transaction_id	string	微信支付订单号
out_trade_no	string	商户订单号
attach	string	商家数据包
time_end	string	支付完成时间
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	商品单价

参阅官方文档

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

直连商户模式

合作伙伴模式

区块链电子发票

自建/三方模式

免确认

免确认

直连商户模式

合作伙伴模式

进件(融合钱包)

基础支付

账单

清关报关

支付押金（付款码支付） ​

支付押金（付款码支付）