申请退款
一笔退款失败后重新提交，请不要更换退款单号，请使用原商户退款单号
| 请求参数 | 类型 | 描述 |
|---|---|---|
| security | true | 声明加载商户API证书 |
| xml | object | 声明请求的XML数据结构 |
| appid | string | 公众账号ID |
| sub_appid | string | 子商户公众账号ID |
| mch_id | string | 商户号 |
| sub_mch_id | string | 子商户号 |
| sign_type | string | 签名类型MD5 | HMAC-SHA256 枚举值之一 |
| transaction_id | string | 微信订单号 |
| out_trade_no | string | 商户订单号 |
| out_refund_no | string | 商户退款单号 |
| total_fee | integer | 订单金额 |
| refund_fee | integer | 退款金额 |
| refund_fee_type | string | 退款货币种类 |
| refund_desc | string | 退款原因 |
| refund_account | string | 退款资金来源 |
| notify_url | string | 退款结果通知url |
php
$instance->v2->secapi->pay->refund->postAsync([
'security' => true,
'xml' => [
'appid' => 'wx8888888888888888',
'sub_appid' => 'wx8888888888888888',
'mch_id' => '1900000109',
'sub_mch_id' => '1900000109',
'sign_type' => 'HMAC-SHA256',
'transaction_id' => '1217752501201407033233368018',
'out_trade_no' => '1217752501201407033233368018',
'out_refund_no' => '1217752501201407033233368018',
'total_fee' => '100',
'refund_fee' => '100',
'refund_fee_type' => 'CNY',
'refund_desc' => '商品已售完',
'refund_account' => 'REFUND_SOURCE_RECHARGE_FUNDS',
'notify_url' => 'https://weixin.qq.com/notify/',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
})
->wait();php
$instance->chain('v2/secapi/pay/refund')->postAsync([
'security' => true,
'xml' => [
'appid' => 'wx8888888888888888',
'sub_appid' => 'wx8888888888888888',
'mch_id' => '1900000109',
'sub_mch_id' => '1900000109',
'sign_type' => 'HMAC-SHA256',
'transaction_id' => '1217752501201407033233368018',
'out_trade_no' => '1217752501201407033233368018',
'out_refund_no' => '1217752501201407033233368018',
'total_fee' => '100',
'refund_fee' => '100',
'refund_fee_type' => 'CNY',
'refund_desc' => '商品已售完',
'refund_account' => 'REFUND_SOURCE_RECHARGE_FUNDS',
'notify_url' => 'https://weixin.qq.com/notify/',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
})
->wait();php
$instance['v2/secapi/pay/refund']->postAsync([
'security' => true,
'xml' => [
'appid' => 'wx8888888888888888',
'sub_appid' => 'wx8888888888888888',
'mch_id' => '1900000109',
'sub_mch_id' => '1900000109',
'sign_type' => 'HMAC-SHA256',
'transaction_id' => '1217752501201407033233368018',
'out_trade_no' => '1217752501201407033233368018',
'out_refund_no' => '1217752501201407033233368018',
'total_fee' => '100',
'refund_fee' => '100',
'refund_fee_type' => 'CNY',
'refund_desc' => '商品已售完',
'refund_account' => 'REFUND_SOURCE_RECHARGE_FUNDS',
'notify_url' => 'https://weixin.qq.com/notify/',
],
])
->then(static function(\Psr\Http\Message\ResponseInterface $response) {
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));
})
->wait();php
$response = $instance->v2->secapi->pay->refund->post([
'security' => true,
'xml' => [
'appid' => 'wx8888888888888888',
'sub_appid' => 'wx8888888888888888',
'mch_id' => '1900000109',
'sub_mch_id' => '1900000109',
'sign_type' => 'HMAC-SHA256',
'transaction_id' => '1217752501201407033233368018',
'out_trade_no' => '1217752501201407033233368018',
'out_refund_no' => '1217752501201407033233368018',
'total_fee' => '100',
'refund_fee' => '100',
'refund_fee_type' => 'CNY',
'refund_desc' => '商品已售完',
'refund_account' => 'REFUND_SOURCE_RECHARGE_FUNDS',
'notify_url' => 'https://weixin.qq.com/notify/',
],
]);
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));php
$response = $instance->chain('v2/secapi/pay/refund')->post([
'security' => true,
'xml' => [
'appid' => 'wx8888888888888888',
'sub_appid' => 'wx8888888888888888',
'mch_id' => '1900000109',
'sub_mch_id' => '1900000109',
'sign_type' => 'HMAC-SHA256',
'transaction_id' => '1217752501201407033233368018',
'out_trade_no' => '1217752501201407033233368018',
'out_refund_no' => '1217752501201407033233368018',
'total_fee' => '100',
'refund_fee' => '100',
'refund_fee_type' => 'CNY',
'refund_desc' => '商品已售完',
'refund_account' => 'REFUND_SOURCE_RECHARGE_FUNDS',
'notify_url' => 'https://weixin.qq.com/notify/',
],
]);
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));php
$response = $instance['v2/secapi/pay/refund']->post([
'security' => true,
'xml' => [
'appid' => 'wx8888888888888888',
'sub_appid' => 'wx8888888888888888',
'mch_id' => '1900000109',
'sub_mch_id' => '1900000109',
'sign_type' => 'HMAC-SHA256',
'transaction_id' => '1217752501201407033233368018',
'out_trade_no' => '1217752501201407033233368018',
'out_refund_no' => '1217752501201407033233368018',
'total_fee' => '100',
'refund_fee' => '100',
'refund_fee_type' => 'CNY',
'refund_desc' => '商品已售完',
'refund_account' => 'REFUND_SOURCE_RECHARGE_FUNDS',
'notify_url' => 'https://weixin.qq.com/notify/',
],
]);
print_r(\WeChatPay\Transformer::toArray((string) $response->getBody()));| 返回字典 | 类型 | 描述 |
|---|---|---|
| return_code | string | 返回状态码SUCCESS | FAIL 枚举值之一 |
| return_msg | string | 返回信息 |
| result_code | string | 业务结果SUCCESS | FAIL 枚举值之一 |
| err_code | string | 错误代码 |
| err_code_des | string | 错误代码描述 |
| appid | string | 公众账号ID |
| mch_id | string | 商户号 |
| sub_appid | string | 子商户公众账号ID |
| sub_mch_id | string | 子商户号 |
| nonce_str | string | 随机字符串 |
| sign | string | 签名 |
| transaction_id | string | 微信订单号 |
| out_trade_no | string | 商户订单号 |
| out_refund_no | string | 商户退款单号 |
| refund_id | string | 微信退款单号 |
| refund_fee | integer | 退款金额 |
| settlement_refund_fee | integer | 应结退款金额 |
| total_fee | integer | 标价金额 |
| settlement_total_fee | integer | 应结订单金额 |
| fee_type | string | 标价币种 |
| cash_fee | integer | 现金支付金额 |
| cash_fee_type | string | 现金支付币种 |
| cash_refund_fee | integer | 现金退款金额 |
| coupon_type_$n | string | 代金券类型 |
| coupon_refund_fee | integer | 代金券退款总金额 |
| coupon_refund_fee_$n | integer | 单个代金券退款金额 |
| coupon_refund_count | integer | 退款代金券使用数量 |
| coupon_refund_id_$n | string | 退款代金券ID |
参阅 官方付款码文档 官方JSAPI文档 官方NATIVE文档 官方APP文档 官方H5文档 官方小程序支付文档 官方刷脸支付文档