19支付 - 文档中心

订单退款接口

对已经支付的订单发起退款,请求方式为 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"}
最后更新: 2020-03-07