订单退款接口
对已经支付的订单发起退款,请求方式为 POST
请求地址
环境 | HTTPS请求地址 |
正式环境 | https://19zf.cn/api/refund.html |
请求参数
参数 | 类型 | 是否必填 | 描述 | 示例值 |
app_id | String | 是 | 19支付平台分配和商户的APPID,19开头 | 191008821006 |
out_trade_no | String | 特殊可选 | 商户订单号,与 pay_order_id 不能同时为空; 如果同时存在优先级:pay_order_id > out_trade_no |
20150320010101001 |
pay_order_id | String | 特殊可选 | 19支付平台 订单号,与 out_trade_no 不能同时为空; 如果同时存在优先级:pay_order_id > out_trade_no |
19开头 |
sign_type | String | 否 | 商户生成签名字符串所使用的签名算法类型,默认支持MD5 | MD5 |
sign | String | 是 | 数据签名,详见 签名算法 | 95AD5686E715127AA03F8324079673F0 |
请求响应参数
参数 | 类型 | 是否必填 | 描述 | 示例值 |
result_code | String | 是 | 接口响应结果 | SUCCESS:请求成功,FAIL:请求失败 |
result_msg | String | 是 | 接口响应结果描述 | 请求成功、请求失败、签名验证失败等 |
app_id | String | 是 | 19支付平台分配和商户的APPID,19开头 | 191008821006 |
mch_id | String | 是 | 合作商户的商户号 | 1575500091 |
total_fee | int | 是 | 订单总金额 | 单位:分 |
pay_order_id | String | 是 | 19支付平台 订单号 | 19开头 |
out_trade_no | String | 是 | 商户订单号,需保证在商户端不重复 | 20150320010101001 |
transaction_id | String | 是 | 微信系统交易单号 | 42000004652019110530698852419 |
refund_fee | int | 是 | 退款金额 | 单位:分 |
refund_no | int | 是 | 退款流水号 | 单位:分 |
sign_type | String | 否 | 默认MD5 | MD5 |
sign | String | 是 | 数据签名,详见 签名算法 | 95AD5686E715127AA03F8324079673F0 |
成功退款的条件是,商户微信账户未结算款 大于 退款金额
请求响应结果示例(本示例仅供参考,具体参数以实际通知为准)
{"app_id":"191008821006","mch_id":"1575500091","out_trade_no":"20150320010101001","pay_order_id":"1919110717036584","refund_fee":"5","refund_no":"R20191108171811275726","result_code":"SUCCESS","result_msg":"成功","sign":"A58940559C328E3D39579725AAD23F45","total_fee":"5","transaction_id":"42000004652019110530698852419"}