订单退款

订单退款

接口描述：

使用场景：支持部分金额退款，隔天交易退款。（建议在交易完成后间隔几分钟（最短5分钟）再调用退款接口，避免出现订单状态同步不及时导致退款失败。）

注：含单品优惠交易只能整单退款，不支持部分退款

调试

在线调试接口open in new window

请求地址

环境	HTTPS请求地址
测试环境	http://test.sdtlpay.com/openapi/v1open in new window
正式环境	http://www.sdtlpay.com/openapi/v1/open in new window

公共请求参数

字段名	中文释义	是否必填	数据类型	备注
version	调用的接口版本	是	string	固定为：1.0 1.0
accessId	开放平台分配给开发者的应用访问ID	是	string	2014072300007148
method	接口名称	是	string	allinpay.shandong.refund
format	请求的参数格式	是	string	仅支持JSON
charset	请求使用的编码格式	是	string	如utf-8,gbk
signType	商户生成签名字符串所使用的签名算法类型	是	string	目前支持RSA2和SM2，推荐使用RSA2
signData	商户请求参数的签名	是	string	详见签名详见示例
timestamp	发送请求的时间	是	string	格式"yyyy-MM-dd HH:mm:ss" 2014-07-24 03:07:50
authToken	详见应用授权概述	否	string
bizContent	业务请求参数集合	是	string	最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务请求参数集合

bizContent 业务参数

参数字段	中文释义	是否必填	类型	备注
merCd	商户号	是	string
appId	产品ID	是	string
orderNo	商户订单号	是	string	本次请求的退款流水号
oriTxnDate	原始交易日期	是	string	原交易日期：YYYYMMDD
oriOrderNo	原始交易订单号	是	string	原订单的请求流水号
amount	退款金额	是	string
randomStr	自定义串	否	string
notifyUrl	异步通知	是	string

公共响应参数

字段名	中文释义	是否必填	数据类型	备注
resCode	网关返回码	是	string	SSSSSS 成功 FFFFF 失败
resMsg	网关返回码描述	是	string	网关返回码描述
bizCode	业务返回码，参见具体的API接口文档	是	string	参见具体的API接口文档
bizMsg	业务返回码描述，参见具体的API接口文档	是	string	参见具体的API接口文档
signType	商户生成签名字符串所使用的签名算法类型	是	string	目前支持RSA2和SM2，推荐使用RSA2
signData	商户请求参数的签名	是	string	详见签名详见示例
resContent	业务返回参数集合	是	string	最大长度不限，除公共参数外所有请求参数都必须放在这个参数中传递，具体参照各产品快速接入文档

业务返回参数集合

提示

resCode=SSSSSS 时, resContent 内参数

参数字段	类型	说明
merCd	String	商户号
proId	String	产品Id
orderNo	String	商户退款订单号
txnOrderNo	String	退款平台流水号
oriOrderNo	String	原交易流水号
amount	String	退款金额
txnFee	String	退款手续费
remark	String	备注信息
txnSta	String	交易状态
txnMsg	String	交易状态描述信息
finTime	String	实际金额