Skip to content

请求赔付预下单

商户可调用该接口进行赔付预下单,并锁定商户资金。若赔付订单状态已经为终态(成功或关闭),接口将返回错误码。在预下单成功后,商户需携带接口返回的跳转参数,引导用户至微信内进行确认,用户确认后执行赔付。若预下单后超过24小时没有赔付成功,系统将自动关闭订单。订单赔付成功或者关闭时,系统将通过接口指定的商户回调地址通知赔付结果。

请求参数类型描述
jsonobject声明请求的JSON数据结构
sp_appidstring公众账号ID
receiverobject收款方信息
typestring转账接收方类型
MERCHANT | TRANSACTION_USER 枚举值之一
transaction_infoobject转账接收方订单信息
transaction_idstring交易订单号
out_bill_nostring商户单号
amountnumber赔付金额
transfer_remarkstring赔付原因
sponsor_mchidstring出资商户号
transfer_scene_idstring转账场景ID
user_recv_perceptionstring用户收款感知
notify_urlstring商户回调地址
php
$instance->v3->platsolution->ecommerce->mchTransfer->compensateBills->preTransfer->postAsync([
  'json' => [
    'sp_appid'             => 'wx8888888888888888',
    'receiver'             => [
      'type'             => 'MERCHANT',
      'transaction_info' => [
        'transaction_id' => '1217752501201407033233368018',
      ],
    ],
    'out_bill_no'          => 'plfk2020042013',
    'amount'               => 10000,
    'transfer_remark'      => '直播违规扣罚',
    'sponsor_mchid'        => '1900001109',
    'transfer_scene_id'    => '1001',
    'user_recv_perception' => '退货运费补偿',
    'notify_url'           => 'https://www.weixin.qq.com/wxpay/pay.php',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance->chain('v3/platsolution/ecommerce/mch-transfer/compensate-bills/pre-transfer')->postAsync([
  'json' => [
    'sp_appid'             => 'wx8888888888888888',
    'receiver'             => [
      'type'             => 'MERCHANT',
      'transaction_info' => [
        'transaction_id' => '1217752501201407033233368018',
      ],
    ],
    'out_bill_no'          => 'plfk2020042013',
    'amount'               => 10000,
    'transfer_remark'      => '直播违规扣罚',
    'sponsor_mchid'        => '1900001109',
    'transfer_scene_id'    => '1001',
    'user_recv_perception' => '退货运费补偿',
    'notify_url'           => 'https://www.weixin.qq.com/wxpay/pay.php',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$instance['v3/platsolution/ecommerce/mch-transfer/compensate-bills/pre-transfer']->postAsync([
  'json' => [
    'sp_appid'             => 'wx8888888888888888',
    'receiver'             => [
      'type'             => 'MERCHANT',
      'transaction_info' => [
        'transaction_id' => '1217752501201407033233368018',
      ],
    ],
    'out_bill_no'          => 'plfk2020042013',
    'amount'               => 10000,
    'transfer_remark'      => '直播违规扣罚',
    'sponsor_mchid'        => '1900001109',
    'transfer_scene_id'    => '1001',
    'user_recv_perception' => '退货运费补偿',
    'notify_url'           => 'https://www.weixin.qq.com/wxpay/pay.php',
  ],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
  print_r(json_decode((string) $response->getBody(), true));
})
->wait();
php
$response = $instance->v3->platsolution->ecommerce->mchTransfer->compensateBills->preTransfer->post([
  'json' => [
    'sp_appid'             => 'wx8888888888888888',
    'receiver'             => [
      'type'             => 'MERCHANT',
      'transaction_info' => [
        'transaction_id' => '1217752501201407033233368018',
      ],
    ],
    'out_bill_no'          => 'plfk2020042013',
    'amount'               => 10000,
    'transfer_remark'      => '直播违规扣罚',
    'sponsor_mchid'        => '1900001109',
    'transfer_scene_id'    => '1001',
    'user_recv_perception' => '退货运费补偿',
    'notify_url'           => 'https://www.weixin.qq.com/wxpay/pay.php',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance->chain('v3/platsolution/ecommerce/mch-transfer/compensate-bills/pre-transfer')->post([
  'json' => [
    'sp_appid'             => 'wx8888888888888888',
    'receiver'             => [
      'type'             => 'MERCHANT',
      'transaction_info' => [
        'transaction_id' => '1217752501201407033233368018',
      ],
    ],
    'out_bill_no'          => 'plfk2020042013',
    'amount'               => 10000,
    'transfer_remark'      => '直播违规扣罚',
    'sponsor_mchid'        => '1900001109',
    'transfer_scene_id'    => '1001',
    'user_recv_perception' => '退货运费补偿',
    'notify_url'           => 'https://www.weixin.qq.com/wxpay/pay.php',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
php
$response = $instance['v3/platsolution/ecommerce/mch-transfer/compensate-bills/pre-transfer']->post([
  'json' => [
    'sp_appid'             => 'wx8888888888888888',
    'receiver'             => [
      'type'             => 'MERCHANT',
      'transaction_info' => [
        'transaction_id' => '1217752501201407033233368018',
      ],
    ],
    'out_bill_no'          => 'plfk2020042013',
    'amount'               => 10000,
    'transfer_remark'      => '直播违规扣罚',
    'sponsor_mchid'        => '1900001109',
    'transfer_scene_id'    => '1001',
    'user_recv_perception' => '退货运费补偿',
    'notify_url'           => 'https://www.weixin.qq.com/wxpay/pay.php',
  ],
]);
print_r(json_decode((string) $response->getBody(), true));
返回字典类型描述
out_bill_nostring商户单号
bill_idstring微信支付转账单号
accept_timestring受理时间
package_infostring跳转领取页面的package信息

参阅 官方文档

Published on the GitHub by TheNorthMemory