易码付-退款查询

应用场景

提交退款申请后，如果申请退款接口返回的refund_state为wait状态，需要通过调用该接口查询退款状态。

接口链接

请求方式：POST

URL地址：{BASE_URL}/v1/transactions/refundid.html

请求参数

字段名	变量名	必填	类型	示例值	描述
应用ID	app_id	是	String	app_9ba59abbe56e057f20f	由易码付平台生成的应用ID，全局唯一。
商户退款单号	out_refund_no	是	String	190011178361713	商户退款单号参数必传，值可以传空商户退款单号和平台退款单号不能同时为空，out_refund_no,refund_no如果同时存在优先取out_refund_no
平台退款单号	refund_no	是	String	TK2108142002121923822	平台退款单号参数必传，值可以传空商户退款单号和平台退款单号不能同时为空，out_refund_no,refund_no如果同时存在优先取out_refund_no
签名串	sign	是	String	aa4bf6d01803310d4d99c9da59dd1f29	待签名字符串进行MD5加密得出的32位签名值，参考签名规则

举例如下：

{BASE_URL}/v1/transactions/refundid.html?app_id=app_159f7a1756bf8b08&out_refund_no=190009507085358&refund_no=TK20220523123254158963&sign=f74e3b4a9e2bcb971c3a68c80286bc8e

返回结果

字段名	变量名	必填	类型	示例值	描述
业务状态码	resultCode	是	Int	200	200/201/500 此字段是业务标识状态码，200代表业务处理成功，并成功返回
业务状态描述	message	是	String	成功	当resultCode非200时返回信息为错误原因，例如 app_id错误或不存在
数据集	Data	否	String	-	当resultCode为200时，数据会装入该字段一并返回
	out_refund_no	是	String	1217752501035987	退款订单：商户端退款单号
	refund_no	是	String	TK2108142002121923822	退款订单：平台退款单号
	platform_refund_no	是	String	188632571217752501201407	退款订单：第三方退款单号
	refund_reason	是	String	缺货	退款订单：退款理由
	refund_msg	是	String	退款成功	退款订单：说明
	refund_amount	是	Int	100	退款订单：退款金额，单位为分。1元等于100分
	refund_state	是	String	success	退款订单：退款状态 success：退款成功 failed：退款失败 wait：退款中 close：订单关闭
	refund_create_time	是	String	2022-09-07 09:41:47	退款订单：退款创建时间，格式yyyy-MM-dd HH:mm:ss
	refund_success_time	是	String	2022-09-07 09:49:47	退款订单：退款成功时间，格式yyyy-MM-dd HH:mm:ss
	trade_no	是	String	YH2307190011178361713	原交易订单：平台交易单号
	out_trade_no	是	String	156354587546455	原交易订单：商户交易单号
	pay_type	是	Int	20	原交易订单：支付方式
	channel	是	String	wx_qr	原交易订单：支付渠道代码
	description	是	String	苹果手机	原交易订单：商品描述
	amount	是	String	100	原交易订单：订单金额，单位为分
	pay_time	是	String	2022-09-05 09:41:47	原交易订单：付款时间，格式yyyy-MM-dd HH:mm:ss

举例如下：

{
    "resultCode":200,
    "message":"成功",
    "Data":{
        "description":"iPhone+13+Pro",
        "channel":"alipay_app",
        "pay_type":30,
        "trade_no":"YH2308251715577476213",
        "out_trade_no":"MER1692954956218",
        "amount":200,
        "pay_time":"2023-08-25 17:15:57",
        "refund_no":"TK2108142002121923822",
        "out_refund_no":"1217752501035987",
        "platform_refund_no":"123175757258019034593871",
        "refund_amount":200,
        "refund_reason":"%E7%BC%BA%E8%B4%A7",
        "refund_msg":"%E9%80%80%E6%AC%BE%E6%88%90%E5%8A%9F",
        "refund_state":"success",
        "refund_create_time":"2022-09-07 09:41:47",
        "refund_success_time":"2022-09-07 09:49:47",
        "app_id":"app_7ca649d7cef5deb2"
    }
}

状态码

状态码	描述
200	成功
201	业务错误，具体错误信息请参照message字段
500	系统错误

API接口文档

退款查询

应用场景

接口链接

请求参数

返回结果

状态码